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LabVIEW 


LabVIEW programs are called virtual instruments, or VIs, because their 
appearance and operation imitate physical instruments, such as 
oscilloscopes and multimeters. LabVIEW contains a comprehensive set of 
tools for acquiring analyzing, displaying, and storing data, as well as tools 
to help you troubleshoot your code. 


LabVIEW VIs contain three components-the front panel, the block 
diagram, and the icon and connector pane. This lesson describes the front 
panel and the block diagram; refer to Modular Programming for more 
information about the icon and the connector pane. 


In LabVIEW, you build a user interface, or front panel, with controls and 
indicators. Controls are knobs, push buttons, dials, and other input devices. 
Indicators are graphs, LEDs, and other displays. After you build the user 
interface, you add code using VIs and structures to control the front panel 
objects. The block diagram contains this code. In some ways, the block 
diagram resembles a flowchart. 


Use LabVIEW to communicate with hardware such as data acquisition, 
vision, and motion control devices, and GPIB, PXI, VXI, RS-232, and RS- 
484 devices. LabVIEW also has built-in features for connecting your 
application to the Web using the LabVIEW Web Server and software 
standards such as TCP/IP networking and ActiveX. 


Using LabVIEW, you can create test and measurement, data acquisitions, 
instrument control, datalogging, measurement analysis, and report 
generation applications. You also can create stand-alone executables and 
shared libraries, like DLLs, because LabVIEW is a true 32-bit compiler. 


LabVIEW Environment 


When you launch LabVIEW, the navigation dialog box appears that 
includes introductory material and common commands. 
p>! LabVIEW 
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LabVIEW Dialog Box 


The LabVIEW dialog box includes the following components: 


e A menu with standard items such as File>>Exit. 
e A set of buttons for creating and opening VIs, configuring data 
acquisition devices, and finding helpful information. 


© Click the New button to create a new VI. Click the arrow on the 
New button to choose to open a blank VI or to open the New 
dialog box. 

o Click the Open button to open an existing VI. Click the arrow on 
the Open button to open recent files. 


o Click the Configure button to configure your data acquisition 
devices. Click the arrow on the Configure button to configure 
LabVIEW. 

o Click the Help button to launch the LabVIEW Help. Click the 
arrow on the HeLp button for other Help options, including the 
NI Example Finder. 


Creating and Saving a VI 


When you click the New button in the LabVIEW dialog box, the New 
dialog box appears. You also can select File>>New to display this dialog 
box. When you select a template in the Create new list, previews of the 
VI appear inthe Front panel preview andthe Block diagram 
preview sections, and a description of the template appears in the 
Description section. [link] shows the New dialog box and the SuUbVI 
with Error Handling VI template. 
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New Dialog Box 


Click the OK button to open the template. You also can double-click the 
name of the template VI in the Create new list to open the template. If 
no template is available for the task you want to create, you can start with a 
blank VI and create a VI to accomplish the specific task. In the LabVIEW 
dialog box, click the arrow on the New button and select Blank VI from 
the shortcut menu or press the Ctr L-N keys to open a blank VI. 


Note: You also can open a blank VI by selecting 


Blank 
VI 


from the 

Create new 

list in the 

New 

dialog box or by selecting 


File>>New 
VI 


Open/Templates 


Use the New dialog box to create different components in LabVIEW to help 
you build an application. You can start with a blank VI to write a VI from 
scratch, or start with a template to simplify the programming. The New 
dialog box includes the following components: 


¢ Create new Displays templates you can use to start building VIs and 
other LabVIEW documents. Select from the following templates and 
click the OK button to start building a VI or other LabVIEW document. 


© Blank VI Opens a blank front panel and blank block diagram. 

© VI from Template Opens a front panel and block diagram with 
components you need to build different types of VIs. 

o Other Document Types Opens the tools you use to build other 
LabVIEW objects. 


¢ Browse for Template Displays the Browse dialog box so you can 
navigate to a VI, control, or template. If you previously have browsed 


for and selected a template from this dialog box, use the pull-down 
menu of the Browse button to select a template to reopen it. 

¢ Front panel preview Displays the front panel for the VI template you 
selected in the Create new list. 

¢ Block diagram preview Displays the block diagram for the VI 
template you selected in the Create new list. 

¢ Description Displays a description of the template you selected in the 
Create new list if the template includes a description. 


Opening an Existing VI 


You load a VI into memory by selecting File>>Open. In the Choose 
the VI to open dialog box that appears, navigate to the VI you want 
to open. 


The VIs you edit in this course are located in the 
C:\Exercises\LabVIEW Basics I directory. 


As the VI loads, a status dialog box similar to [link] might appear. 
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Loading: 2 Loaded 


C:\Program Files\National Instruments\LabVIEW 6\examples\apps\freqresp. llb\Demo 
Tek FG 5010. vi 


Searching: 
C:\Program Files\National Instruments\LabVIEW 7. O0\vi.lib\Dag\1easyio. IIb 
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The Loading section lists the subVIs of the VI as they are loaded into 
memory. Number Loaded is the number of subVIs loaded into memory 


so far. You can cancel the load at any time by clicking the Stop button. 


If LabVIEW cannot immediately locate a subVI, it begins searching 
through all directories specified by the VI Search Path. You can edit 
the VI Search Path by selecting Tools>>Options and selecting 
Paths from the top pull-down menu. The Searching section lists 
directories or VIs as LabVIEW searches through them. You can have 
LabVIEW ignore a subVI by clicking the Ignore SubVI button, or you 
can click the Browse button to search for the missing subVI. 


Saving VIs 


Select Save, Save As, Save All, or Save with Options from 
the File menu to save VIs as individual files or group several VIs together 
and save them in a VI library. VI library files end with the extension . 11b. 
National Instruments recommends that you save VIs as individual files, 
organized in directories, especially if multiple developers are working on 
the same project. 


LabVIEW uses the native file dialog boxes so they act similar to other 
applications on the computer. You can disable this feature by selecting 
Tools>>Options and selecting Miscellaneous from the top pull- 
down menu. If you disable native file dialogs, LabVIEW uses its own 
platform-independent file dialog boxes with some convenient features, such 
as providing a list of recent paths and reducing the steps necessary to save 
VIs in VI libraries. 


Moving VIs Across Platforms 


You can transfer VIs from one platform to another, such as from Mac OS to 
Windows. LabVIEW automatically translates and recompiles the VIs on the 
new platform. 


Because VIs are files, you can use any file transfer method or utility to 
move VIs between platforms. You can port VIs over networks using FTP, Z 
or XModem protocols, or similar utilities. Such network transfers eliminate 
the need for additional file translation software. If you port VIs using 
magnetic media, such as floppy disks or a moveable external hard drive, 
you need a generic file transfer utility program, such as the following: 


¢ (Windows) MacDisk and TransferPro transfer Mac OS files to the PC 
format and vice versa. 

e (Mac OS) DOS Mounter, MacLink, and Apple File Exchange convert 
PC files to the Mac OS format and vice versa. 

e (Sun) PC File System (PCFS) converts PC files to the Sun format and 
vice versa. 


Note: Certain operating system-specific VIs are not portable between 
platforms, such as DDE (Dynamic Data Exchange) VIs, ActiveX VIs, and 
AppleEvents. 


Refer to the Porting and Localizing LabVIEW VIs Application Note, 
available by selecting Help>>Search the LabVIEW Bookshelf, 
for more information about porting VIs. 


Menus 


The menus at the top of a VI window contain items common to other 
applications, such as Open, Save, Copy, and Paste, and other items 
specific to LabVIEW. Some menu items also list shortcut key combinations. 


(Mac OS) The menus appear at the top of the screen. 


(Windows and UNIX) The menus display only the most recently used 
items by default. Click the arrows at the bottom of a menu to display all 
items. You can display all menu items by default by selecting 


Tools>>Options and selecting Miscellaneous from the top pull- 
down menu. 


Note: Some menu items are unavailable while a VI is in run mode. 


e The File menu contains items used for basic file operations, such as 
opening, closing, saving, and printing files. 

e The Edit menu contains items that allow you to search for and 
modify LabVIEW files and their components. 

e The Operate menu contains items you use to control the operation of 
Vis. 

¢ The TOOLS menu contains items for configuring LabVIEW, your 
projects, and your VIs. 

e The Browse menu contains items that allow you to view aspects of 
the current VI and its hierarchy. 

e The Window menu contains items that allow you to configure the 
appearance of the current windows and palettes. You also can access 
the Error List window and view the contents of the clipboard. 

e The Help menu contains items to explain and define LabVIEW 
features and other components, provide full LabVIEW documentation, 
and access National Instruments technical support. 


Front Panel and Block Diagram Windows 


When you open a blank VI, an untitled front panel window appears. This 
window displays the front panel and is one of the two LabVIEW windows 
you use to build a VI. The other window contains the block diagram. The 
illustration in [link] shows a front panel and its corresponding block 
diagram with front panel and block diagram components. 
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1. Toolbar, 2. Owned Label, 3. Numeric Control, 4. Free Label, 5. 
Numeric Control Terminal, 6. Knob Terminal, 7. Numeric Constant, 8. 
Multiply Function, 9. Icon, 10. Knob Control, 11. Plot Legend, 12. XY 

Graph, 13. Wire Data Path, 14. XY Graph Terminal, 15. Bundle 
Function, 16. SubVI, 17. For Loop Structure 


Front Panel Toolbar 


Use the toolbar buttons to run and edit a VI. The toolbar in [link] appears 
on the front panel. 
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Click the Run button to run a VI. LabVIEW compiles the VI, if necessary. 
You can run a VI if the Run button appears as a solid white arrow. The solid 
white arrow, shown above, also indicates you can use the VI as a subV]I if 
you create a connector pane for the VI. 


While the VI runs, the Run button appears as shown at left if the VI is a 
top-level VI, meaning it has no callers and therefore is not a subVI. 


If the VI that is running is a subVI, the Run button appears as shown at left. 
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The Run button appears broken, shown at left, when the VI you are 
creating or editing contains errors. If the Run button still appears broken 


after you finish wiring the block diagram, the VI is broken and cannot run. 
Click this button to display the Error list window, which lists all 
errors and warnings. 


Click the Run Continuous1y button, shown at left, to run the VI until 
you abort or pause execution. You also can click the button again to disable 
continuous running. 
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While the VI runs, the Abort Execution button, shown at left, appears. 
Click this button to stop the VI immediately if there is no other way to stop 
the VI. If more than one running top-level VI uses the VI, the button is 
dimmed. 


Note: Avoid using the 
Abort Execution 


button to stop a VI. Either let the VI complete its data flow or design a 
method to stop the VI programmatically. By doing so, the VI is at a known 
state. For example, place a button on the front panel that stops the VI when 
you Click it. 
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Click the Pause button, shown at left, to pause a running VI. When you 
click the Pause button, LabVIEW highlights on the block diagram the 
location where you paused execution, and the Pause button appears red. 
Click the button again to continue running the VI. 
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Select the Text Settings pull-down menu, shown at left, to change the 
font settings for the selected portions of the VI, including size, style, and 
color. 
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Select the ALign Objects pull-down menu, shown at left, to align 
objects along axes, including vertical, top edge, left, and so on. 


Select the Distribute Objects pull-down menu, shown at left, to 
space objects evenly, including gaps, compression, and so on. 


Select the ReSize Objects pull-down menu, shown at left, to resize 
multiple front panel objects to the same size. 


Select the Reorder pull-down menu, shown at left, when you have objects 
that overlap each other and you want to define which one is in front or back 
of another. Select one of the objects with the Positioning tool and then 
select from Move Forward, Move Backward, Move To Front, and 
Move To Back. 


Select the Show Context Help Window button, shown at left, to 
toggle the display of the Context Help window. 


Type appears to remind you that a new value is available to replace an old 
value. The Enter button disappears when you click it, press the Enter key, 
or click the front panel or block diagram workspace. 


Block Diagram Toolbar 


When you run a VI, buttons appear on the block diagram toolbar that you 
can use to debug the VI. The toolbar in [link] appears on the block diagram. 
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Click the Highlight Execution button, shown at left, to display an 
animation of the block diagram execution when you click the Run button. 
see the flow of data through the block diagram. Click the button again to 
disable execution highlighting. 


Click the Step Into button, shown at left, to open a node and pause. 
When you click the Step Into button again, it executes the first action 
and pauses at the next action of the subVI or structure. You also can press 
the Ctrl and down arrow keys. Single-stepping through a VI steps through 
the VI node by node. Each node blinks to denote when it is ready to 
execute. By stepping into the node, you are ready to single-step inside the 
node. 


Click the Step Over button, shown at left, to execute a node and pause at 
the next node. You also can press the Ctrl and right arrow keys. By 
stepping over the node, you execute the node without single-stepping 
through the node. 
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Click the Step Out button, shown at left, to finish executing the current 
node and pause. When the VI finishes executing, the Step Out button 
becomes dimmed. You also can press the Ctr 1 and up arrow keys. By 


stepping out of a node, you complete single-stepping through the node and 
go to the next node. 
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The Warning button, shown at left, appears if a VI includes a warming and 
you placed a checkmark in the Show Warnings checkbox in the Error 
List window. A warning indicates there is a potential problem with the 
block diagram, but it does not stop the VI from running. 


Palettes 


LabVIEW has graphical, floating palettes to help you create and run VIs. 
The three palettes include the Tools, Controls, and Functions 
palettes. You can place these palettes anywhere on the screen. 


Tools Palette 


You can create, modify, and debug VIs using the tools located on the 
floating Tools palette. The Tools palette is available on both the front 
panel and the block diagram. A tool is a special operating mode of the 
mouse cursor. The cursor corresponds to the icon of the tool selected in the 
Tools palette. Use the tools to operate and modify front panel and block 
diagram objects. 


Select Window>>Show Tools Palette to display the Tools palette. 


Note: Press the 
Shift 
key and right-click to display a temporary version of the 


Tools 


palette at the location of the cursor. 


Tools 
Palett 
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If automatic tool selection is enabled and you move the cursor over objects 
on the front panel or block diagram, LabVIEW automatically selects the 
corresponding tool from the Tools palette. You can disable automatic tool 
selection and select a tool manually by clicking the tool you want on the 
Tools palette. 


If you want to use the Tab key to cycle through the four most common 
tools on the Tools palette, click the Automatic Tool Selection 
button, shown at left, on the TOOLS palette to disable automatic tool 
selection. Press the Shift - Tab keys or click the Automatic Tool 
Selection button to enable automatic tool selection again. You also can 
manually select a tool on the ToOLs palette to disable automatic tool 
selection. Press the Tab or Shift - Tab keys or click the Automatic 
Tool Selection button on the Tools palette to enable automatic tool 
selection again. If automatic tool selection is disabled, you can press the 
spacebar to switch to the next most useful tool. 
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Use the Operating tool, shown at left, to change the values of a control 
or select the text within a control. The Operating tool changes to the 
icon shown at left when it moves over a text control, such as a numeric or 
string control. 
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Use the PoSitioning tool, shown at left, to select, move, or resize 
objects. The POSitioning tool changes to resizing handles when it 
moves over the edge of a resizable object. 


Use the Labeling tool, shown at left, to edit text and create free labels. 
The Labeling tool changes to the following icon when you create free 
labels. 


Use the Wiring tool, shown at left, to wire objects together on the block 
diagram. 


Use the Object Shortcut Menu, shown at left, tool to access an 
object shortcut menu with the left mouse button. 
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Use the Scrolling tool, shown at left, to scroll through windows without 
using scrollbars. 


Use the Breakpoint tool, shown at left, to set breakpoints on VIs, 
functions, nodes, wires, and structures to pause execution at that location. 
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Use the Probe tool, shown at left, to create probes on wires on the block 
diagram. Use the Probe tool to check intermediate values in a VI that 
produces questionable or unexpected results. 


Use the Color Copy tool, shown at left, to copy colors for pasting with 
the Coloring tool. 


Use the Coloring tool, shown at left, to color an object. It also displays 
the current foreground and background color settings. 


Controls and Functions Palettes 


The Controls and Functions palettes contain subpalettes of objects 
you can use to create a VI. When you click a subpalette icon, the entire 
palette changes to the subpalette you selected. To use an object on the 
palettes, click the object and place it on the front panel or block diagram. 


The Controls palette, shown in [link], is available only on the front 
panel. The Controls palette contains the controls and indicators you use 
to build the front panel. Refer to the Front Panel section for more 
information about the using the Controls palette on the front panel. The 
controls and indicators located on the Controls palette depend on the 
palette view currently selected. 


Controls 
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Controls Palette 


The Functions palette, shown in the [link], is available only on the block 
diagram. The Functions palette contains the VIs and functions you use 
to build the block diagram. Refer to the Block Diagram section of this 
lesson for more information about using the Functions palette on the 
block diagram. The VIs and functions located on the Functions palette 
depend on the palette view currently selected. The VIs and functions are 
located on subpalettes based on the types of VIs and functions. 


Functions iol x 


Functions 
Palette 


Changing Palette Views 


Use the Options button on the Controls or Functions palette 
toolbar to change to another palette view or format: 


1. 


Click the Options button, shown at left, on the Controls or 
Functions palette toolbar to display the Controls/Functions 
Palettes page of the Options dialog box. 

2. Select a palette view from the Palette View pull-down menu. 

3. Select a format from the Format pull-down menu, such as 
Standard, AP teons, Alle texc, or Leos and) Texe. 

4. Click the OK button. The Controls and Functions palettes 
change to the palette view and format you selected. 


Searching for Controls, VIs, and Functions 


Use the following navigation buttons on the Controls and Functions 
palettes to navigate and search for controls, VIs, and functions: 


¢ Up to Owning Palette 


Navigates up one level in the palette hierarchy. 
¢ Search 
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Changes the palette to search mode. In search mode, you can perform 
text-based searches to locate controls, VIs, or functions on the palettes. 
For example, if you want to find the Random Number function, click 
the Search button on the Functions palette toolbar and start 
typing Random Number in the text box at the top of the palette. 


LabVIEW lists all matching items that either start with or contain the 
text you typed. You can click one of the search results and drag it to 
the block diagram, as shown in [Link]. 
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Double-click the search result to highlight its location on the palette. You 
then can click the Up to Owning Palette button to view the 
hierarchy of where the object resides. 


Shortcut Menus 


The most often-used menu is the object shortcut menu. All LabVIEW 
objects and empty space on the front panel and block diagram have 
associated shortcut menus. Use the shortcut menu items to change the look 
or behavior of front panel and block diagram objects. To access the shortcut 


menu, right-click the object, front panel, or block diagram. The shortcut 
menu for a meter is shown in [link]. 
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Property Dialog Boxes 


Front panel objects also have property dialog boxes that you can use to 
change the look or behavior of front panel objects. Right-click a front panel 
object and select Properties from the shortcut menu to access the 
property dialog box for an object. [link] shows the property dialog box for 
the meter in the previous figure. The options available on the property 
dialog box for an object are similar to the options available on the shortcut 
menu for that object. 
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Meter Property Dialog Box 


Front Panel 


The front panel is the user interface of the VI. [link] shows an example of a 
front panel. 
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Example of a Front Panel 


Controls and Indicators 


You build the front panel with controls and indicators, which are the 
interactive input and output terminals of the VI, respectively. Controls are 
knobs, push buttons, dials, and other input devices. Indicators are graphs, 
LEDs, and other displays. Controls simulate instrument input devices and 
supply data to the block diagram of the VI. Indicators simulate instrument 
output devices and display data the block diagram acquires or generates. 


Controls Palette 


The Controls palette is available only on the front panel. The 
Controls palette contains the controls and indicators you use to create 
the front panel. Select Window>>Show Controls Palette or right- 
click the front panel workspace to display the Controls palette. Tack 
down the Controls palette by clicking the thumbtack on the top left 
comer of the palette. By default, the Controls palette starts in the 
Express view. 


The Express palette view includes subpalettes on the top level of the 
Controls and Functions palettes that contain Express VIs and other 
objects you need to build common measurement applications. The Al1 
Controls andAll Functions subpalettes contain the complete set of 
built-in controls, indicators, VIs, and functions. 


The Advanced palette view includes subpalettes on the top level of the 
Controls and Functions palettes that contain the complete set of 
built-in controls, indicators, VIs, and functions. The Express subpalettes 
contain Express VIs and other objects you need to build common 
measurement applications. 


Note: In the 


Express 


palette view, toolsets and modules do not install subpalettes on the top 
level of the 


Controls 

and 

Functions 

palettes. Instead, toolsets and modules install on the 


All Controls 


and 

All Functions 
subpalettes. In the 
Advanced 


palette view, toolsets and modules install subpalettes on the top level. 


Click the Options button on the Controls or Functions palette to 
change to another palette view or format. 


Numeric Controls and Indicators 


The two most commonly used numeric objects are the numeric control and 
the numeric indicator, as shown in [link]. 


1. Increment and Decrement 
Buttons, 2. Numeric Control, 3. 
Numeric Indicator 


To enter or change values in a numeric control, click the increment and 
decrement buttons with the Operating tool or double-click the 
number with either the Labeling tool or the Operating tool, type a 
new number, and press the Enter key. 


Boolean Controls and Indicators 


Use Boolean controls and indicators to enter and display Boolean (True or 
False) values. Boolean objects simulate switches, push buttons, and 
LEDs. The most common Boolean objects are the vertical toggle switch and 
the round LED, as shown in [link]. 


Block Diagram 


After you build the front panel, you add code using graphical 
representations of functions to control the front panel objects. The block 
diagram contains this graphical source code. Front panel objects appear as 
terminals, on the block diagram. Block diagram objects include terminals, 
subVIs, functions, constants, structures, and wires, which transfer data 
among other block diagram objects. 


The VI in [link] shows several primary block diagram objects-nodes, 
terminals, and wires. 
add&sub.vi Front Panel * 
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1. Nodes, 2. Indicator Terminals, 3. Wires, 4. Control Terminals 


Functions Palette 


The Functions palette is available only on the block diagram. The 
Functions palette contains the VIs and functions you use to build the 


block diagram. Select Window>>Show Functions Palette or right- 
click the block diagram workspace to display the Functions palette. 
Tack down the Functions palette by clicking the thumbtack on the top 
left corner of the palette. By default, the Functions palette starts in the 
Express view. 


Express VIs, VIs, and Functions 


LabVIEW uses colored icons to distinguish between Express VIs, VIs, and 
functions on the block diagram. By default, icons for Express VIs appear on 
the block diagram as expandable nodes with icons surrounded by a blue 
field. Icons for VIs have white backgrounds, and icons for functions have 
pale yellow backgrounds. 


By default, most functions and VIs on the block diagram appear as icons 
that are not expandable, unlike Express VIs. 


Express VIs 


Use Express VIs for common measurement tasks. Express VIs are nodes 
that require minimal wiring because you configure them with dialog boxes. 
You can save the configuration of an Express VI as a subVI. Refer to 
Building the Block Diagram, of the LabVIEW User Manual for more 
information about creating subVIs from Express VIs. 


VIs 


When you place a VI on the block diagram, LabVIEW considers the VI to 
be a subVI. When you double-click a subVI, its front panel and block 
diagram appear, rather than a dialog box in which you can configure 
options. The front panel includes controls and indicators. The block 
diagram includes wires, front panel icons, functions, possibly subVIs, and 
other LabVIEW objects. 


The upper right corner of the front panel and block diagram displays the 
icon for the VI. This is the icon that appears when you place the VI on the 
block diagram. 


You can create a VI to use as a subVI. Refer to Modular Programming for 
more information about creating VIs and configuring them as subVIs. 


Functions 


Functions are the fundamental operating elements of LabVIEW. Functions 
do not have front panels or block diagrams but do have connector panes. 
Double-clicking a function only selects the function. 


Nodes 


Nodes are objects on the block diagram that have inputs and/or outputs and 
perform operations when a VI runs. They are analogous to statements, 
operators, functions, and subroutines in text-based programming languages. 
Nodes can be functions, subVIs, or structures. Structures are process control 
elements, such as Case structures, For Loops, orWhile Loops. The 
Add and Subtract functions in [link] are function nodes. 


Expandable Nodes versus Icons 


You can display VIs and Express VIs as icons or as expandable nodes. 
Expandable nodes appear as icons surrounded by a colored field. SubVIs 
appear with a yellow field, and Express VIs appear with a blue field. Use 
icons, such as the BaSic Function Generator VI icon if you want 
to conserve space on the block diagram. Use expandable nodes, such as the 
Basic Function Generator VI expandable node to make wiring 
easier and to aid in documenting block diagrams. By default, subVIs appear 
as icons on the block diagram, and Express VIs appear as expandable 
nodes. 


To display a subVI or Express VI as an expandable node, right-click the 
subVI or Express VI and select View As Icon from the shortcut menu 
to remove the checkmark. 


You can resize the expandable node to make wiring even easier, but it also 
takes a large amount of space on the block diagram. Complete the following 
steps to resize a node on the block diagram. 


1. Move the PoSitioning tool over the node. Resizing handles appear 
at the top and bottom of the node. 

2. Move the cursor over a resizing handle to change the cursor to the 
resizing cursor. 

3. Use the resizing cursor to drag the border of the node down to display 
additional terminals. 

4. Release the mouse button. 


To cancel a resizing operation, drag the node border past the block diagram 
window before you release the mouse button. 


[link] shows the Basic Function Generator VI as a resized 
expandable node. 


> amplitude 
Perror in (no error) 
> = Frequency 
> 
> 
>» reset signal 


> signal type 


error out 
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>» sampling info 
Psquare wave duty 
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Note:If you display a subVI or Express VI as an expandable node, you 
cannot display the terminals for that node and you cannot enable database 
access for that node. 


Terminals 


Front panel objects appear as terminals on the block diagram. The terminals 
represent the data type of the control or indicator. You can configure front 
panel controls or indicators to appear as icon or data type terminals on the 
block diagram. By default, front panel objects appear as icon terminals. For 
example, a knob icon terminal, shown at left, represents a knob on the front 
panel. The DBL at the bottom of the terminal represents a data type of 
double-precision, floating-point numeric. To display a terminal as a data 
type on the block diagram, right-click the terminal and select View As 
Icon from the shortcut menu to remove the checkmark. A DBL data type 
terminal, shown above at left, represents a double-precision, floating-point 
numeric control or indicator. 
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Terminals are entry and exit ports that exchange information between the 
front panel and block diagram. Terminals are analogous to parameters and 
constants in text-based programming languages. Types of terminals include 
control or indicator terminals and node terminals. Control and indicator 
terminals belong to front panel controls and indicators. Data you enter into 
the front panel controls (a and 6 in [link]) enter the block diagram through 
the control terminals. The data then enter the Add and Subtract 
functions. When the Add and Subtract functions complete their internal 
calculations, they produce new data values. The data flow to the indicator 
terminals, where they exit the block diagram, reenter the front panel, and 
appear in front panel indicators (a + 6 and a — 6 in [link]). The terminals 


in [link] belong to four front panel controls and indicators. The connector 
panes of the Add and Subtract functions, shown in [link], have three 
node terminals. To display the terminals of the function on the block 
diagram, right-click the function node and select Visible 
Items>>Terminals from the shortcut menu. 


Wires 


You transfer data among block diagram objects through wires. Wires are 
analogous to variables in text-based programming languages. In [link], 
wires connect the control and indicator terminals to the Add and 
Subtract functions. Each wire has a single data source, but you can wire 
it to many VIs and functions that read the data. Wires are different colors, 
styles, and thicknesses, depending on their data types. A broken wire 
appears as a dashed black line with a red X in the middle. The examples in 
[link] are the most common wire types. 


Wire 1D 2D 
Type Scalar Array Array Color 
Orange (floating- 
Numeric point), Blue 
(integer) 
Boolean en —— Green 


String cee ees naan Pink 


In LabVIEW, you use wires to connect multiple terminals together to pass 
data in a VI. The wires must be connected to inputs and outputs that are 
compatible with the data that is transferred with the wire. For example, you 
cannot wire an array output to a numeric input. In addition the direction of 
the wires must be correct. The wires must be connected to only one input 
and at least one output. For example, you cannot wire two indicators 
together. The components that determine wiring compatibility include the 
data type of the control and/or indicator and the data type of the terminal. 


Data Types 


Data types indicate what objects, inputs, and outputs you can wire together. 
For example, a switch has a green border so you can wire a switch to any 
input with a green label on an Express VI. A knob has an orange border so 
you can wire a knob to any input with an orange label. However, you 
cannot wire an orange knob to an input with a green label. Notice the wires 
are the same color as the terminal. 
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The dynamic data type stores the information generated or acquired by an 
Express VI. The dynamic data type appears as a dark blue terminal, shown 
at left. Most Express VIs accept and/or return the dynamic data type. You 
can wire the dynamic data type to any indicator or input that accepts 
numeric, waveform, or Boolean data. Wire the dynamic data type to an 
indicator that can best present the data. Indicators include a graph, chart, or 
numeric indicator. 


Most other VIs and functions in LabVIEW do not accept the dynamic data 
type. To use a built-in VI or function to analyze or process the data the 
dynamic data type includes, you must convert the dynamic data type. 
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Use the Convert from Dynamic Data Express VI, shown at left, 
to convert the dynamic data type to numeric, Boolean, waveform, and array 
data types for use with other VIs and functions. When you place the 


Convert from Dynamic Data Express VI on the block diagram, the 
Configure Convert from Dynamic Data dialog box appears. 
The Configure Convert from Dynamic Data dialog box 
displays options that let you specify how you want to format the data that 
the Convert from Dynamic Data Express VI returns. 


When you wire a dynamic data type to an array indicator, LabVIEW 
automatically places the Convert from Dynamic Data Express VI 
on the block diagram. Double-click the Convert from Dynamic 
Data Express VI to open the Configure Convert from Dynamic 
Data dialog box to control how the data appears in the array. 


Use the Convert to Dynamic Data Express VI to convert numeric, 
Boolean, waveform, and array data types to the dynamic data type for use 
with Express VIs. When you place the Convert to Dynamic Data 
Express VI on the block diagram, the Configure Convert to 
Dynamic Data dialog box appears. Use this dialog box to select the kind 
of data to convert to the dynamic data type. 


Automatically Wiring Objects 


LabVIEW automatically wires objects as you place them on the block 
diagram. You also can automatically wire objects already on the block 
diagram. LabVIEW connects the terminals that best match and leaves 
terminals that do not match unconnected. 


As you move a selected object close to other objects on the block diagram, 
LabVIEW draws temporary wires to show you valid connections. When 
you release the mouse button to place the object on the block diagram, 
LabVIEW automatically connects the wires. 


Toggle automatic wiring by pressing the spacebar while you move an object 
using the POSitioning tool. You can adjust the automatic wiring settings 
by selecting Tools>>Options and selecting Block Diagram from 
the top pull-down menu. 


Manually Wiring Objects 


When you pass the Wiring tool over a terminal, a tip strip appears with 
the name of the terminal. In addition, the terminal blinks in the Context 
Help window and on the icon to help you verify that you are wiring to the 
correct terminal. 


Acquiring a Signal VI 
Exercise: 


Problem: 


In the following exercise, you will build a VI that generates a signal 
and displays that signal in a graph. LabVIEW provides templates 
containing information from which you can build a VI. These 
templates help you get started with LabVIEW. 


Complete the following steps to create a VI that generates a signal and 
displays it on the front panel. 


1. Launch LabVIEW. 
2. In the LabVIEW dialog box that appears, shown in [link], click 
the New button to display the New dialog box. 
i> LabVIEW 
File Edit Tools Help 


Configure... 
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LabVIEW 7 


3. Select VI from Template>>Tutorial (Getting 
Started)>>Generate and Display inthe Create 
new list. This template VI generates and displays a signal. Notice 
that previews of the template VI appear in the Front panel 
preview andthe Block diagram preview sections. The 


[link] shows the New dialog box and the Generate and 
Display template VI. 
>! New BEES 


Front panel preview 


Blank ¥I a 
VI From Template 
| EP: Frameworks 
Dialog (Base Package) 
Dialog Using Events 
Single Loop Application 
SubYI with Error Handling 
Top Level Application Using Events 
fr: Design Patterns 
Master/Slave Design Pattern 
Producer/Consumer Design Patt 
Producer/Consumer Design Patt 
Queued Message Handler Block diagram preview 
Standard State Machine 
User Interface Event Handler 
Ey: Instrument 1/0 (GPIB) 
Read and Display 
=; Simulated 
Generate and Display 
Load From File and Display 
© pe Tutorial (Getting Started) 
Generate, Analyze, and Display 
Generate and Display 
Other Document Types 


Use this template to simulate the 
acquisition and display of data by 
generating data, Note: VIs created from 
this template will have automatic error 
handling enabled by default. 


alll = 
Browse for Template... | 
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4. Click the OK button to open the template. You also can double- 
click the name of the template VI in the Create new list to 
open the template. 

5. Examine the front panel of the VI. The user interface, or front 
panel, appears with a gray background and includes controls and 
indicators. The title bar of the front panel indicates that this 
window is the front panel for the Generate and Display 
VI. 


Note: If the front panel is not visible, you can display the front 
panel by selecting Window>>Show Front Panel. 


6. Examine the block diagram of the VI. The block diagram appears 
with a white background and includes VIs and structures that 
control the front panel objects. The title bar of the block diagram 
indicates that this window is the block diagram for the 
Generate and Display VI. 


Note: If the block diagram is not visible, you can display the 
block diagram by selecting Window>>Show Block 
Diagram. 


7. [Bl 


On the front panel toolbar, click the Run button, shown at left. 
Notice that a sine wave appears on the graph. 


8. |js10e | 


Stop the VI by clicking the Stop button, shown at left, on the 
front panel. 


Adding a Control to the Front Panel 


Controls on the front panel simulate the input devices on a physical 
instrument and supply data to the block diagram of the VI. Many 
physical instruments have knobs you can turn to change an input 
value. Complete the following steps to add a knob control to the front 
panel. 


Note: Throughout these exercises, you can undo recent edits by 
selecting 


Edit>>Undo 
or pressing the 
Ctrl-Z 


keys. 


1. If the Controls palette is not visible on the front panel, select 
Window>>Show Controls Palette to display it. 

2. Move the cursor over the icons on the Controls palette to 
locate the Numeric Controls palette. Notice that when you 
move the cursor over icons on the Controls palette, the name 
of that subpalette appears in the gray space above all the icons on 
the palette. When you idle the cursor over any icon on any 
palette, the full name of the subpalette, control, or indicator 
appears. 

3. Click the Numeric Controls icon to access the Numeric 
Controls palette. 

4. Select the knob control on the Numeric Controls palette and 
place it on the front panel to the left of the waveform graph. You 
will use this knob in a later exercise to control the amplitude of a 
signal. 

5. Select File>>Save As and save this Vilas Acquiring a 
Signal.vi inthe C:\Exercises\LabVIEW Basics I 
directory. 


Note: Save all the VIs you edit or create in this course in the 
C:\Exercises\LabVIEW Basics I directory. 


Changing the Signal Type 


The block diagram has a blue icon labeled Simulate Signal. This 
icon represents the Simulate Signal Express VI. The 
Simulate Signal Express VI simulates a sine wave by default. 
Complete the following steps to change this signal to a sawtooth wave. 


1. Display the block diagram by selecting Window>>Show 
Block Diagram or by clicking the block diagram. 


Simulate Signal 


Notice the Simulate Signal Express VI, shown in [link]. An 
Express VI is a component of the block diagram that you can 
configure to perform common measurement tasks. The 
Simulate Signal Express VI simulates a signal based on the 
configuration that you specify. 

2. Right-click the Simulate Signal Express VI and select 
Properties from the shortcut menu to display the 
Configure Simulate Signal dialog box. 

3. Select Sawtooth from the Signal type pull-down menu. 
Notice that the waveform on the graph in the Result 
Preview section changes to a sawtooth wave. The Configure 
Simulate Signal dialog box should appear similar to [Link]. 


| Configure Simulate Signal [Simulate Signal] 


Signal Result Preview 
Signal type 
[Sawtooth >| 
Frequency (Hz) Phase (deg) 
fio.3 0 3 
Amplitude Offset Duty cycle (%) 2 
= t 

fi lo 50 
T Add noise 

Noise type 

[Uniform White Noise x 

Time 
Noise amplitude Seed number Trials 
lo.1 | TT i a — Time Stamps 
{ Relative to start of measurement 

Timing ‘a : 
SR ee Absolute (date and time) 
fiooo © Simulate acquisition timing Les 
Number of samples © Run as Fast as possible € Reset phase, seed, and time stamps 
fioo IV Automatic f@ Use continuous generation 
[J Integer number of cycles — Signal Name 

Actual number of samples IV Use signal type name 

100 Signal name 
Actual frequency [Sawtooth 
10.3 


OK | Cancel | Help | 


4. Click the OK button to apply the current configuration and close 
the Configure Simulate Signal dialog box. 
Move the cursor over the down arrows at the bottom of the 
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Simulate Signal Express VI. 
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When a double-headed arrow appears, shown at left, click and 
drag the border of the Express VI until the Amplitude input 
appears. Notice how you expanded the Simulate Signal 
Express VI to display a new input. Because the Amplitude 
input appears on the block diagram, you can configure the 
amplitude of the sawtooth wave on the block diagram. In [link], 
notice how Amplitude is an option in the Configure 


Simulate Signal dialog box. When inputs, such as 
Amplitude, appear on the block diagram and in the 
configuration dialog box, you can configure the inputs in either 
location. 


Wiring Objects on the Block Diagram 


To use the knob control to change the amplitude of the signal, you 
must connect the two objects on the block diagram. Complete the 

following steps to wire the knob to the Amplitude input on the 

Simulate Signal Express VI. 
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Move the cursor over the Knob terminal, shown at left, until the 
Positioning tool appears. 
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Notice how the cursor becomes an arrow, or the Positioning 
tool, shown in [link]. Use the Positioning tool to select, 
position, and resize objects. 


Click the Knob terminal to select it, then drag the terminal to the 
left of the Simulate Signal Express VI. Make sure the 
Knob terminal is inside the loop, shown in [link]. The terminals 
are representations of front panel controls and indicators. 
Terminals are entry and exit ports that exchange information 
between the front panel and block diagram. 


3. Deselect the Knob terminal by clicking a blank space on the 
block diagram. 
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Move the cursor over the arrow of the Knob terminal, shown in 
[link]. 


Notice how the cursor becomes a wire spool, or the Wiring tool, 
shown at left. Use the Wiring tool to wire objects together on 
the block diagram. 


Note: The cursor does not switch to another tool while an object 
is selected. 


Simulate Signal 
Sawtooth » 
error out » 


When the Wiring tool appears, click the arrow and then click 
the Amplitude input of the Simulate Signal Express VI, 
shown in [link], to wire the two objects together. Notice that a 
wire appears and connects the two objects. Data flows along this 
wire from the terminal to the Express VI. 

6. Select File>>Save to save this VI. 


Running the VI 


Running a VI executes your solution. Complete the following steps to 
run the ACquiring a Signal VI. 


1. Display the front panel by selecting Window>>Show Front 
Panel or by clicking the front panel. 


Note: Press the Ctr'1-E keys to switch from the front panel to 
the block diagram or from the block diagram to the front panel. 


2. Click the Run button. 
3. Move the cursor over the knob control. 
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Notice how the cursor becomes a hand, or the Operating tool, 
shown at left. Use the Operating tool to change the value of a 
control or select the text within a control. 

4. Using the Operating tool, turn the knob to adjust the 
amplitude of the sawtooth wave. Notice how the amplitude of the 
sawtooth wave changes as you turn the knob. Also notice that the 
y-axis on the graph autoscales to account for the change in 
amplitude. 


®| 


To indicate that the VI is running, the Run button changes to a 
darkened arrow, shown at left. You cannot edit the front panel or 
block diagram while the VI runs. 


5. [roe 


Click the Stop button, shown at left, to stop the VI. 


Note: Although 

Abort Execution 

button looks like a stop button, the 
Abort Execution 


button does not always properly close the VI. National Instruments 
recommends stopping your VIs using the 


Stop 
button on the front panel. Use the 
Abort Execution 


button only when errors prevent you from terminating the application 
using the 


Stop 


button. 


Modifying the Signal 


Complete the following steps to add scaling to the signal and display 
the results in the graph on the front panel. 


On the block diagram, use the POSitioning tool to double- 
click the wire that connects the Simulate Signal Express VI 
to the Waveform Graph terminal shown in [link]. 

. Press the Delete key to delete this wire. 

. If the Functions palette is not visible on the block diagram, 
select Window>>Show Functions Palette to display it. 
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Scale & Map 


Select the Scaling and Mapping Express VI, shown at left, 
onthe Arithmetic & Comparison palette and place it on 
the block diagram inside the loop between the Simulate 
Signal Express VI and the Waveform Graph terminal. If 
there is no room between the Express VI and the terminal, move 
the Waveform Graph terminal to the right. Notice that the 
Configure Scaling and Mapping dialog box 
automatically opens when you place the Express VI on the block 
diagram. 

. Define the value of the scaling factor by entering 10 in the 
Slope (m) text box. The Configure Scaling and 
Mapping dialog box should appear similar to [link]. 


Configure Scaling and Mapping [Scaling and... E@ 


6. Click the OK button to apply the current configuration and close 
the Configure Scaling and Mapping dialog box. 

7. Move the cursor over the arrow on the Sawtooth output of the 
Simulate Signal Express VI. 
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When the Wiring tool appears, click the arrow and then click the 
arrow on the Signals input of the Scaling and Mapping 
Express VI, shown in [link], to wire the two objects together. 

9. Using the Wiring tool, wire the Scaled Signals output of 
the Scaling and Mapping Express VI to the Waveform 
Graph terminal. Notice the wires connecting the Express VIs 
and terminals. The arrows on the Express VIs and terminals 


indicate the direction that the data flows along these wires. The 
block diagram should appear similar to [link]. 


\>! Generate and Display [Acquiring a Signal.vi] Block Diagram * [lel x] 
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Scaling and 
Simulate Signal Mapping 


Sawtooth > 
Scaled Signals > 
> Amplitude 


Note: The terminals in the block diagram are set to display as 
icons. To display a terminal as a data type on the block diagram, 
right-click the terminal and select View As Icon from the 
shortcut menu to remove the checkmark. 


10. Select File>>Save to save this VI. 


Displaying Two Signals on the Graph 


To compare the signal generated by the Simulate Signal Express 
VI and the signal modified by the Scaling and Mapping Express 
VI on the same graph, use the Merge Signals function. Complete 
the following steps to display two signals on the same graph. 


1. Move the cursor over the arrow on the Sawtooth output of the 
Simulate Signal Express VI. 


2. Using the Wiring tool, wire the Sawtooth output to the 
Waveform Graph terminal. 
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The Merge Signals function, shown in [link], appears where 
the two wires connect. This function takes the two separate 
signals and combines them so that both can be displayed on the 
same graph. The block diagram should appear similar to [link]. 


if! Generate and Display [Acquiring a Signal.vi] Block Diagram * 
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3. Select FLle>>Save to save this VI. You also can press the 
Ctr1-S keys to save a VI. 

4. Return to the front panel, run the VI, and turn the knob control. 
Notice that the graph plots the sawtooth wave and the scaled 
signal. Also notice that the maximum value on the y-axis 
automatically changes to be 10 times the knob value. This scaling 
occurs because you set the slope to 10 in the Scaling and 
Mapping Express VI. 

5. Click the Stop button. 


Customizing the Knob 


The knob control changes the amplitude of the sawtooth wave so 
labeling it Amplitude accurately describes the function of the knob. 
Complete the following steps to customize the appearance of a control 
on the front panel. 


1. Right-click the knob and select Properties from the shortcut 
menu to display the Knob Properties dialog box. 

2. In the Label section on the Appearance tab, delete the label 
Knob, and type Amplitude in the text box. The Knob 

Properties dialog box should appear similar to [link]. 


if» Knob Properties: Amplitude 
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3. Click the Scale tab and, inthe Scale Range section, change 
the maximum value to 5.0. Notice how the knob on the front 
panel instantly updates to reflect these changes. 

4. Click the OK button to apply the current configuration and close 
the Knob Properties dialog box. 

5. Save this VI. 


Note: As you build VIs, you can experiment with different 
properties and configurations. You also can add and delete 
objects. Remember, you can undo recent edits by selecting 
Edit>>Undo or pressing the Ctrl-Z keys. 


. Experiment with other properties of the knob by using the Knob 
Properties dialog box. For example, try changing the colors 
forthe Marker Text Color by clicking the color box located 
on the Scale tab. 

. Click the Cancel button to avoid applying the changes you 
made while experimenting. If you want to keep the changes you 
made, click the OK button. 


Customizing the Waveform Graph 


The waveform graph indicator displays the two signals. To 
indicate which plot is the scaled signal and which is the simulated 
signal, you customize the plots. Complete the following steps to 
customize the appearance of an indicator on the front panel. 


1. Move the cursor over the top of the plot legend on the 
waveform graph. Notice that while there are two plots on the 
graph, the plot Legend displays only one plot. 

2. When a double-headed arrow appears, shown in [link], click and 
drag the border of the plot legend until the second plot name 
appears. 


10. 
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. Right-click the waveform graph and select Properties 


from the shortcut menu to display the Graph Properties 
dialog box. 


.On the Plots tab, select Sawtooth from the pull-down menu. 


Click the Line Color color box to display the color 
picker. Select a new line color. 


. Select Sawtooth (Scaled) from the pull-down menu. 
. Place a checkmark in the Don't use waveform names 


for plot names checkbox. 


. In the Name text box, delete the current label and change the 


name of this plot to Scaled Sawtooth. 


. Click the OK button to apply the current configuration and close 


the Graph Properties dialog box. Notice how the plot color 
on the front panel changes. 


. Experiment with other properties of the graph by using the 


Graph Properties dialog box. For example, try disabling 
the autoscale feature located on the Scales tab. 

Click the Cancel button to avoid applying the changes you 
made while experimenting. If you want to keep the changes you 
made, click the OK button. 

Save and close this VI. 


LabVIEW Documentation Resources 


LabVIEW Documentation Resources 


Use the Context Help window, the LabVIEW Help, and the NI Example 
Finder to help you build and edit VIs. Refer to the LabVIEW Help and 
manuals for more information about LabVIEW. 


Context Help Window 


The Context Help window displays basic information about LabVIEW 
objects when you move the cursor over each object. The Context Help 
window is visible by default. To toggle display of the Context Help 
window, select He lp>>Show Context Help, press the Ctr1l-H keys, 
or click the Show Context Help Window button, shown in [link], on 
the toolbar. 


When you move the cursor over front panel and block diagram objects, the 
Context Help window displays the icon for subVIs, functions, 
constants, controls, and indicators, with wires attached to each terminal. 
When you move the cursor over dialog box options, the Context Help 
window displays descriptions of those options. In the window, required 
connections are bold, recommended connections are plain text, and optional 
connections are dimmed or do not appear. [link] shows an example 
Context Help window. 


lf Context Help | _ (OF x} 


Format (%.3F} new File path (Not 4 Pathi... 
File path (dialog if empty} 
number of rows (all:-1) 


transpose (no:F) 


Read From Spreadsheet File.vi 


Reads a specified number of lines or rows From a numeric text File beginning at a 
specified character offset and converts the data to a 2D, single-precision array of 
numbers, 


Click here for more help. 


Context Help Window 


Click the Hide Optional Terminals and Full Path button 
located on the lower left corner of the Context Help window to display 
the optional terminals of a connector pane and to display the full path to a 
VI. Optional terminals are shown by wire stubs, informing you that other 


connections exist. The detailed mode displays all terminals, as shown in 
[ink]. 


i> Context Help 


Format (%.3F) 4 new File path (Not 4 Pathi... 
File path (dialog if empty) 5 all rows 
number of rows (all:-1} ca first row 
start of read offset (chars... - : “mark after read (chars.} 
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transpose (no:F) : 
delimiter (Tab) 


Read From Spreadsheet File.vi 


Reads a specified number of lines or rows From a numeric text File beginning at a 
specified character offset and converts the data to a 2D, single-precision array of 
numbers, 


Click here for more help. 


Detailed Context Help Window 


Click the Lock Context Help button to lock the current contents of 
the Context Help window. When the contents are locked, moving the 
cursor over another object does not change the contents of the window. To 
unlock the window, click the button again. You also can access this option 
from the Help menu. 
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If a corresponding LabVIEW Help topic exists for an object the Context 
Help window describes, ablueClick here for more help. link 
appears in the Context Help window. Also, the More Help button, 
shown at left, is enabled. Click the link or the button to display the 
LabVIEW Help for more information about the object. 


LabVIEW Help 


You can access the LabVIEW Help either by clicking the More Help 
button in the Context Help window, selecting Help>>VI, 
Function, & How-To Help, or clicking the blue Click here 
for more help. link inthe Context Help window. 


The LabVIEW Help contains detailed descriptions of most palettes, menus, 
tools, VIs, and functions. The LabVIEW Help also includes step-by-step 
instructions for using LabVIEW features. The LabVIEW Help includes 
links to the following resources: 


e LabVIEW Bookshelf, which includes PDF versions of all the 
LabVIEW manuals and Application Notes. 

e Technical support resources on the National Instruments Web site, 
such as the NI Developer Zone, the Knowledge Base, and the Product 


Manuals Library. 


NI Example Finder 


The New dialog box contains many LabVIEW template VIs that you can 
use to start building VIs. However, these template VIs are only a subset of 
the hundreds of example VIs included with LabVIEW. You can modify any 
example VI to fit an application, or you can copy and paste from an 
example into a VI that you create. 


In addition to the example VIs that ship with LabVIEW, you also can access 
hundreds of example VIs on the NI Developer Zone at ni.com/zone. To 
search all examples using LabVIEW VIs, use the NI Example Finder. 
The NI Example Finder is the gateway to all installed examples and 
the examples located on the NI Developer Zone. 


To launch the NI Example Finder, select He lp>>Find Examples 
from the front panel or block diagram menu bar. You also can launch the NI 
Example Finder by clicking the arrow on the Open button on the 
LabVIEW dialog box and selecting Examples from the shortcut menu. 


Reduce Samples VI 
Exercise: 


Problem: 


In the following exercises, you will open a blank VI and add Express 
VIs and structures to the block diagram to build anew VI. When you 
complete the exercise, the front panel of the VI will appear similar to 
the [link]. 
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Opening a Blank VI 


If no template is available for the task you want to create, you can start 
with a blank VI and add Express VIs to accomplish the specific task. 
Complete the following steps to open a blank VI. 


1. In the LabVIEW dialog box, click the arrow on the New button 
and select BLank VI from the shortcut menu or press the 
Ctr1-N keys to open a blank VI. Notice that a blank front panel 
and block diagram appear. 


2. a 


If the Functions palette is not visible, right-click any blank 
space on the block diagram to display the Functions palette. 
Click the thumbtack, shown in [link], in the upper left corner of 
the Functions palette to place the palette on the screen. 


Note: You can right-click a blank space on the block diagram or the 
front panel to display the 


Functions 
Or 
Controls 


palettes. 


Adding an Express VI that Simulates a Signal 


Complete the following steps to find the Express VI you want to use 
and then add it to the block diagram. 


If the Context Help window is not visible, press the Ctr 1-H 
keys to open the Context Help window. You also can press 
the Show Context Help Window button, shown in [link], 
to open the Context Help window. 

2. Select the Input palette on the Functions palette and move 
the cursor over the Express VIs on the Input palette. Notice that 
the Context Help window displays information about the 
function of each Express VI. 


3. From the information provided in the Context Help window, 
find the Express VI that can simulate a sine wave signal. 

4. Select the Express VI and place it on the block diagram. The 
Configure Simulate Signal dialog box appears. 

5. Idle the cursor over the various options in the Configure 
Simulate Signal dialog box, suchas Frequency (HZ), 
Amplitude, andSamples per second (Hz). Read the 
information that appears in the Context Help window. 

6. Configure the Simulate Signal Express VI to generate a 
sine wave with a frequency of 10.7 and amplitude of 2. 

7. Notice how the signal displayed in the Result Preview 
window changes to reflect the configured sine wave. 

8. Close the Configure Simulate Signal dialog box by 
clicking the OK button. 

9. Move the cursor over the Simulate Signal Express VI and 
read the information that appears in the Context Help 
window. Notice that the Context Help window now displays 
the configuration of the Simulate Signal Express VI. 

10. Save this VIas Reduce Samples. v1 inthe 
C:\Exercises\LabVIEW Basics I directory. 


Modifying the Signal 


Complete the following steps to use the LabVIEW Help to search for 
the Express VI that reduces the number of samples in a signal. 


1. Select Help>>VI, Function, & How-To Help to open 
the LabVIEW Help. 

2. Click the Search tab and type Sample compression in the 
Type in the word(s) to search for text box. Notice 
that this word choice reflects what you want this Express VI to 
do-compress, or reduce, the number of samples in a signal. 

3. To begin the search, press the Enter key or click the List 
Topics button. 


. Double-click the Sample Compression topic to display the 


topic that describes the Sample Compression Express VI. 


. After you read the description of the Express VI, click the Place 


on the block diagram button to select the Express VI. 


. Move the cursor to the block diagram. Notice how LabVIEW 


attaches the Sample Compression Express VI to the cursor. 


. Place the Sample Compression Express VI on the block 


diagram to the right of the Simulate Signal Express VI. 


. Configure the Sample Compression Express VI to reduce 


the signal by a factor of 25 using the mean of these values. 


. Close the Configure Sample Compression dialog box. 
10. 


Using the Wiring tool, wire the Sine output in the Simulate 
Signal Express VI to the Signals input in the Sample 
Compression Express VI. 


Customizing the Front Panel 


In a previous exercise, you added controls and indicators to the front 
panel using the Controls palette. You also can add controls and 
indicators from the block diagram. Complete the following steps to 
create controls and indicators as shown in [link]. 


> Sample 
Simulate Signal | § Compression 


. Right-click the Mean output in the Sample Compression 
Express VI and select Create>>Numeric Indicator from 
the shortcut menu to create a numeric indicator. 

. Right-click the Mean output of the Sample Compression 
Express VI and select Insert Input/Output from the 
shortcut menu to insert the Enable input. 

. Right-click the Enable input and select Create>>Control 
from the shortcut menu to create the Enableswitch. 

. Right-click the wire linking the Sine output in the Simulate 
Signal Express VI to the Signals input in the Signal 
Compression Express VI and select Create>>Graph 
Indicator from the shortcut menu. Notice that you can create 
controls and indicators from the block diagram. When you create 
controls and indicators using this method, LabVIEW 
automatically creates terminals that are labeled and formatted 
correctly. 

. Using the Wiring tool, wire the Mean output in the Sample 
Compression Express VI to the Sine graph indicator terminal 
created in the previous step. Notice that the Merge Signals 
function appears. 

. Arrange the objects on the block diagram so that they appear 
similar to [link]. 


Note: You can right-click any wire and select Clean Up 
Wire from the shortcut menu to automatically route an existing 
wire. 


7. Display the front panel. Notice that the controls and indicators 
you added automatically appear on the front panel with labels that 
correspond to their function. 

8. Save this VI. 


Configuring the VI to Run Continuously Until the User 
Stops It 


In the current state, the VI runs once, generates one signal, then stops 
executing. To run the VI until a condition is met, you can add a While 
Loop to the block diagram. Complete the following steps to add a 
While Loop. 


1. Display the front panel and run the VI. Notice how the VI runs 
once and then stops. Also notice how there is no Stop button. 

2. Display the block diagram and select the While Loop on the 
Functions>>Execution Control palette. 

3. Move the cursor to the upper left corner of the block diagram. 
Place the top left corner of the While Loop here. 

4. Click and drag the cursor diagonally to enclose all the Express 
VIs and wires, as shown in [link]. 
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Notice that the While Loop, shown in [link], appears with a 
Stop button wired to the condition terminal. This While Loop 
is configured to stop when the user clicks the Stop button. 

5. Display the front panel and run the VI. Notice that the VI now 
runs until you click the Stop button. AWhile Loop executes 
the functions inside the loop until the user presses the Stop 
button. Refer to Repetition and Loops for more information about 
While Loops. 


Controlling the Speed of Execution 


To plot the points on the waveform graph more slowly, you can add a 
time delay to the block diagram. Complete the following steps to 
control the speed at which the VI executes. 


1. On the block diagram, select the Time Delay Express VI on 
the Functions>>Execution Control palette and place it 
inside the loop. 

2. Type .250 inthe Time delay (seconds) text box. This 
time delay specifies how fast the loop runs. With a .250 second 
time delay, the loop iterates once every quarter of a second. 

. Close the Configure Time Delay dialog box. 

. Save this VI. 

. Display the front panel and run the VI. 

. Click the Enable switch and notice the change on the graph. 
Notice how if the Enable switch is on, the graph displays the 
reduced signal. If the Enable switch is off, the graph does not 
display the reduced signal. 

7. Click the Stop button to stop the VI. 
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Using a Table to Display Data 


Complete the following steps to display a collection of mean values in 
a table on the front panel. 


1. On the front panel, select the Express Table indicator on the 
Controls>>Text Indicators palette and place it on the 
front panel to the right of the waveform graph. 

2. Display the block diagram. Notice that the Table terminal 
appears wired to the Build Table Express VI automatically. 


If the Build Table Express VI and the Table terminal are 
not selected already, click an open space on the block diagram to 
the left of the Build Table Express VI and the Table 


terminal. Drag the cursor diagonally until the selection rectangle 
encloses the Build Table Express VI and the Table 
terminal, shown in [link]. A moving dashed outline called a 
marquee highlights the Build Table Express VI, the Table 
terminal, and the wire joining the two. 

4. Drag the objects into the While Loop to the right of the Mean 
terminal. Notice that the While Loop automatically resizes to 
enclose the Build Table Express VI and the Table terminal. 

5. Using the Wiring tool, wire the Mean terminal of the Sample 
Compression Express VI to the Signals input of the Build 
Table Express VI. The block diagram should appear similar to 

[link]. 
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6. Display the front panel and run the VI. 

7. Click the Enable switch. The table displays the mean values of 
every 25 samples of the sine wave. Notice if the Enable switch 
is off, the table does not record the mean values. 

. Stop the VI. 

9. Experiment with properties of the table by using the Table 
Properties dialog box. For example, try changing the number 
of columns to one. 

10. Save and close this VI. 


jee) 


Debugging Techniques 


If a VI does not run, it is a broken, or nonexecutable, VI. The Run button 
often appears broken, shown at left, when you create or edit a VI. If it is 
still broken when you finish wiring the block diagram, the VI is broken and 
will not run. Generally, this means that a required input is not wired, or a 
wire is broken. 


Finding Errors 


Click the broken Run button or select Windows>>Show Error List 
to display the Error list window, which lists all the errors. Double- 
click an error description to display the relevant block diagram or front 
panel and highlight the object that contains the error. 


Execution Highlighting 
8 


View an animation of the execution of the block diagram by clicking the 
Highlight Execution button, shown in [link]. Execution highlighting 
shows the flow of data on the block diagram from one node to another 
using bubbles that move along the wires. Use execution highlighting in 
conjunction with single-stepping to see how data move from node to node 
through a VI. 


Note: Execution highlighting greatly reduces the speed at which the VI 
runs. 


Single-Stepping 


Single-step through a VI to view each action of the VI on the block diagram 
as the VI runs. The single-stepping buttons affect execution only in a VI or 
subVI in single-step mode. Enter single-step mode by clicking the Step 
Over or Step Into button. Move the cursor over the Step Over, 
Step Into, or Step Out button to view a tip strip that describes the 
next step if you click that button. You can single-step through subVIs or run 
them normally. 


If you single-step through a VI with execution highlighting on, an execution 
glyph, shown in [link], appears on the icons of the subVIs that are currently 
running. 


Probes 


cS 


Use the Probe tool, shown in [link], to check intermediate values on a 
wire as a VFI runs. When execution pauses at a node because of single- 
stepping or a breakpoint, you also can probe the wire that just executed to 
see the value that flowed through that wire. 


You also can create a custom probe to specify which indicator you use to 
view the probed data. For example, if you are viewing numeric data, you 
can choose to see that data in a chart within the probe. To create a custom 
probe, right-click a wire and select Custom Probe>>New from the 
shortcut menu. 


Breakpoints 


Use the Breakpoint tool, shown in [link], to place a breakpoint on a VI, 
node, or wire on the block diagram and pause execution at that locatiFon. 
When you set a breakpoint on a wire, execution pauses after data pass 


through the wire. Place a breakpoint on the block diagram workspace to 
pause execution after all nodes on the block diagram execute. When a VI 
pauses at a breakpoint, LabVIEW brings the block diagram to the front and 
uses a marquee to highlight the node or wire that contains the breakpoint. 
LabVIEW highlights breakpoints with red borders for nodes and block 
diagrams and red bullets for wires. When you move the cursor over an 
existing breakpoint, the black area of the Breakpoint tool cursor appears 
white. Use the Breakpoint tool to click an existing breakpoint to remove 
it. 


Debug Exercise (Main) VI 
Exercise: 


Problem: 


Complete the following steps to load a broken VI and correct the error. 
Use single-stepping and execution highlighting to step through the VI. 


Front Panel 


1. Select File>>Open and navigate to 
C:\Exercises\LabVIEW Basics I to open the Debug 
Exercise (Main) VI. The front panel shown in [link] 
appears. 


Notice the Run button on the toolbar appears broken, shown in 
[link], indicating that the VI is broken and cannot run. 


Block Diagram 


1. Select Window>>Show Block Diagram to display the block 
diagram shown in [link]. 
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The Random Number (0-1) function, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, produces a random number between 0 and 1. 


> 


The Multiply function, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, multiplies the random number by 10.0. 


The numeric constant, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, is the number to multiply by the random 
number. 


The Debug Exercise (Sub) VI, located in the 
C:\Exercises\ LabVIEW Basics I directory, adds 
100.0 and calculates the square root of the value. 

2. Find and fix each error. 


1. Click the broken Run button to display the Error list 
window, which lists all the errors. 

2. Select an error description inthe Error list window. 
The Details section describes the error and in some cases 
recommends how to correct the error. 

3. Click the He Lp button to display a topic in the LabVIEW 
Help that describes the error in detail and includes step-by- 
step instructions for correcting the error. 

4. Click the Show Error button or double-click the error 
description to highlight the area on the block diagram that 
contains the error. 

5. Use the Error list window to fix each error. 


3. Select File>>Save to save the VI. 
4. Display the front panel by clicking it or by selecting 
Window>>Show Front Panel. 


Run the VI 


1. Click the Run button to run the VI several times. 

2. Select Window>>Show Block Diagram to display the block 
diagram. 

3. Animate the flow of data through the block diagram. 


1. [2] 


Click the Highlight Execution button, shown in 
[link], on the toolbar to enable execution highlighting. 


2. bal 


Click the Step Into button, shown in [link], to start 
single-stepping. Execution highlighting shows the movement 
of data on the block diagram from one node to another using 
bubbles that move along the wires. Nodes blink to indicate 
they are ready to execute. 


3. (al 


Click the Step Over button, shown in [link], after each 
node to step through the entire block diagram. Each time you 
click the Step Over button, the current node executes and 
pauses at the next node. Data appear on the front panel as 
you step through the VI. The VI generates a random number 
and multiplies it by 10.0. The subVI adds 100.0 and takes 
the square root of the result. 


4. |as| 


When a blinking border surrounds the entire block diagram, 
click the Step Out button, shown in [link], to stop single- 


stepping through the Debug Exercise (Main) VI. 
4. Single-step through the VI and its subVI. 
1. Click the Step Into button to start single-stepping. 


2. [®| 


When the Debug Exercise (Sub) VI blinks, click the 
Step Into button. Notice the run button on the subVI. 


2; 

Display the Debug Exercise (Main) VI block 
diagram by clicking it. A green glyph, shown in [link], 
appears on the subVI icon on the Debug Exercise 
(Main) VI block diagram, indicating that the subVI is 
running. 

4. Display the Debug Exercise (Sub) VI block diagram 
by clicking it. 

5. Click the Step Out button twice to finish single-stepping 
through the subVI block diagram. The Debug Exercise 
(Main) VI block diagram is active. 

6. Click the Step Out button to stop single-stepping. 


5. Use a probe to check intermediate values on a wire as a VI runs. 


1. | 


Use the Probe tool, shown [link], to click any wire. A 
window similar to [link] appears. 
i> [1] Probe EG 


LabVIEW numbers the Probe window automatically and 
displays the same number in a glyph on the wire you clicked. 


2. Single-step through the VI again. The Probe window 
displays data passed along the wire. 


6. Place breakpoints on the block diagram to pause execution at that 
location. 


1. [@ 


Use the Breakpoint tool, shown in [link], to click nodes 
or wires. Place a breakpoint on the block diagram to pause 
execution after all nodes on the block diagram execute. 

2. Click the Run button to run the VI. When you reach a 
breakpoint during execution, the VI pauses and the Pause 
button on the toolbar appears red. 


3. [a 


Click the Continue button, shown [link], to continue 
running to the next breakpoint or until the VI finishes 
running. 

4. Use the Breakpoint tool to click the breakpoints you set 
and remove them. 


7. Click the Highlight Execution button to disable execution 
highlighting. 
8. Select File>>Close to close the VI and all open windows. 


Summary, Tips, and Tricks on Introduction to LabVIEW 


Summary 


e Virtual instruments (VIs) contain three main components-the front 
panel, the block diagram, and the icon and connector pane. 

e The front panel is the user interface of a VI and specifies the inputs 
and displays the outputs of the VI. 

¢ The block diagram contains the graphical source code composed of 
nodes, terminals, and wires. 

e Use the Tools palette to create, modify, and debug VIs. Press the 
Shift key and right-click to display a temporary version of the 
Tools palette at the location of the cursor. 

e Use the Controls palette to place controls and indicators on the 
front panel. Right-click an open space on the front panel to display the 
Controls palette. 

e Use the Functions palette to place VIs and functions on the block 
diagram. Right-click an open space on the block diagram to display the 
Functions palette. 

e Use the Search button on the Controls and Functions palettes 
to search for controls, VIs, and functions. 

e All LabVIEW objects and empty space on the front panel and block 
diagram have associated shortcut menus, which you access by right- 
clicking an object, the front panel, or the block diagram. 

e Use the Help menu to display the Context Help window and the 
LabVIEW Help, which describes most palettes, menus, tools, VIs, 
functions, and features. 

e Select Help>>Search the LabVIEW Bookshelf to display 
the LabVIEW Bookshelf, which you can use to search PDF versions of 
all the LabVIEW manuals and Application Notes. 

e You build the front panel with controls and indicators, which are the 
interactive input and output terminals of the VI, respectively. 

¢ Control terminals have a thicker border than indicator terminals. To 
change a control to an indicator or to change an indicator to a control, 
right-click the object and select Change to Indicator or 
Change to Control from the shortcut menu. 


The block diagram is composed of nodes, terminals, and wires. 

The broken Run button appears on the toolbar to indicate the VI is 
broken. Click the broken Run button to display the Error list 
window, which lists all the errors. 

Use execution highlighting, single-stepping, probes, and breakpoints to 
debug VIs by animating the flow of data through the block diagram. 


Tips and Tricks 


Operating 


Frequently used menu options have equivalent keyboard shortcuts. For 
example, to save a VI, you can select File>>Save or press the 
Ctr1l-S keys. Common keyboard shortcuts include the following: 


Ctrl-R Runs a VI. 

Ctrl-E Toggles between the front panel and block diagram. 

Ctrl-H Toggles display of the Context Help window. 

CtrlI-B Removes all broken wires. 

Ctrl-F Finds VIs, globals, functions, text, or other objects loaded in 
memory or in a specified list of VIs. 


To increment or decrement numeric controls faster, use the 
Operating or Labeling tools to place the cursor in the control 
and press the Shift key while pressing the up or down arrow keys. 
You can disable the debugging tools to reduce memory requirements 
and to increase performance slightly. Select File>>VI 
Properties, select Execution from the top pull-down menu, and 
remove the checkmark from the Allow Debugging checkbox. 


Wiring 


Click the Show Context Help Window button on the toolbar to 
display the Context Help window. Use the Context Help 
window to determine which terminals are required. Required terminals 


are bold, recommended connections are plain text, and optional 
connections are dimmed. 

e Press the spacebar to toggle the wire direction. 

e To move objects one pixel, press the arrow keys. To move objects 
several pixels, press the Shift key while you press the arrow keys. 

e To cancel a wire you started, press the ESC key, right-click, or click 
the terminal where you started the wire. 

e Use the tip strips that appear as you move the Wiring tool over 
terminals. 

e Display the connector pane by right-clicking the node and selecting 
Visible Items>>Terminals from the shortcut menu. 

e You can bend a wire by clicking to tack the wire down and moving the 
cursor in a perpendicular direction. To tack down a wire and break it, 
double-click. 


1. Tack Down a Wire by Clicking, 2. Tack and Break the Wire 
by Double-clicking 


Editing 


Use the following shortcuts to create constants, controls, and 
indicators: 


o Right-click a function terminal and select 
Create>>Constant, Create>>Control, or 
Create>>Indicator from the shortcut menu. 

o Drag controls and indicators from the front panel to the block 
diagram to create a constant. 

o Drag constants from the block diagram to the front panel to create 
a control. 


To duplicate an object, press the Ctrl key while using the Positioning 
tool to click and drag a selection. 

To restrict an object's direction of movement horizontally or vertically, 
use the POSiti0ning tool to select the object and press the Shift 
key while you move the object. 

To keep an object proportional to its original size as you resize it, press 
the Shift key while you drag the resizing handles or circles. 

To resize an object as you place it on the front panel, press the Ctrl 
key while you click to place the object and drag the resizing handles or 
circles. 

To replace nodes, right-click the node and select Replace from the 
shortcut menu. 

To display the block diagram of a subVI from the calling VI, press the 
Ctrl key and use the Operating or Positioning tool to 
double-click the subVI on the block diagram. 

To display the front panel of a subVI from the calling VI, use the 
Operating or Positioning tool to double-click the subVI on 
the block diagram. You also can select Browse>>This VI's 

SUDV IS. 

After you type a label, press the Enter key to end text entry. 

To add items quickly to ring controls and Case structures, press the 
Shift -Enter keys after each item. Pressing Shift-Enter 
accepts the item and positions the cursor to add the next item. Refer to 
Making Decisions in a VI for more information about Case structures. 
To copy the color of one object and transfer it to a second object 
without using a color picker, use the Color Copy tool to click the 


object whose color you want to copy. Use the Coloring tool to click 
the object to which you want to apply the color. You also can copy the 
color of one object by using the Coloring tool and pressing the 
Ctrl key. 

e Select Edit>>Undo if you make a mistake. 

¢ To create more blank space on the block diagram, press the Ctr 1 key 
while you use the POSiti0ning tool to draw a rectangle on the 
block diagram. 


Debugging 
e When single-stepping, use the following keyboard shortcuts: 


¢ Ctrl-down arrow Steps into a node. 
¢ Ctrl-right arrow Steps over a node. 
e Ctrl-up arrow Steps out of a node. 


Modular Programming 


The power of LabVIEW lies in the hierarchical nature of the VI. After you 
create a VI, you can use it on the block diagram of another VI. There is no 
limit on the number of layers in the hierarchy. Using modular programming 
helps you manage changes and debug the block diagram quickly. 


A VI within another VI is called a subVI. A subVI corresponds to a 
subroutine in text-based programming languages. When you double-click a 
subVI, a front panel and block diagram appear, rather than a dialog box in 
which you can configure options. The front panel includes controls and 
indicators that might look familiar. The block diagram includes wires, front 
panel icons, functions, possibly subVIs, and other LabVIEW objects that 
also might look familiar. 


The upper right corner of the front panel and block diagram displays the 
icon for the VI. This icon is the same as the icon that appears when you 
place the VI on the block diagram. 


Icon and Connector Pane 


After you build a front panel and block diagram, build the icon and the 
connector pane so you can use the VI as a subVI. Every VI displays an 
icon, such as the one shown in [link], in the upper right corner of the front 
panel and block diagram windows. An icon is a graphical representation of 
a VI. It can contain text, images, or a combination of both. If you use a VI 
as a subVI, the icon identifies the subVI on the block diagram of the VI. 
You can double-click the icon to customize or edit it. 


You also need to build a connector pane, shown in [link], to use the VI as a 
subVI. The connector pane is a set of terminals that correspond to the 
controls and indicators of that VI, similar to the parameter list of a function 


call in text-based programming languages. The connector pane defines the 
inputs and outputs you can wire to the VI so you can use it as a subVI. A 
connector pane receives data at its input terminals and passes the data to the 
block diagram code through the front panel controls and receives the results 
at its output terminals from the front panel indicators. 


As you create VIs, you might find that you perform a certain operation 
frequently. Consider using subVIs or loops to perform that operation 
repetitively. For example, the block diagram in [link] contains two identical 
operations. 
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You can create a subVI that performs that operation and call the subVI 
twice. The example in [link] calls the Temperature VI as a subVI twice 
on its block diagram and functions the same as the previous block 
diagram. You also can reuse the subVI in other VIs. Refer to Repetition and 
Loops for more information about using loops to combine common 
operations. 


Compound 
Arithmetic Output 


Refer to the LabVIEW Basics II: Development Course Manual for more 
information about application development. The following pseudo-code and 
block diagrams demonstrate the analogy between subVIs and subroutines. 
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Icons and Connector Panes 


After you build a VI front panel and block diagram, build the icon and the 
connector pane so you can use the VI as a subVI. 


Creating an Icon 


Every VI displays an icon, shown in [link], in the upper right corner of the 
front panel and block diagram windows. An icon is a graphical 
representation of a VI. It can contain text, images, or a combination of both. 
If you use a VI as a subVI, the icon identifies the subVI on the block 
diagram of the VI. 


The default icon contains a number that indicates how many new VIs you 
have opened since launching LabVIEW. Create custom icons to replace the 
default icon by right-clicking the icon in the upper right corner of the front 
panel or block diagram and selecting Edit Icon from the shortcut menu 
or double-clicking the icon in the upper right corner of the front panel. You 
also can edit icons by selecting File>>VI Properties selecting 
General fromthe Category pull-down menu, and clicking the Edit 
Icon button. 


Use the tools on the left side of the Icon Editor dialog box to create 
the icon design in the editing area. The normal size image of the icon 
appears in the appropriate box to the right of the editing area, as shown in 
the dialog box in [link]. 
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Depending on the type of monitor you use, you can design a separate icon 
for monochrome, 16-color, and 256-color mode. LabVIEW uses the 
monochrome icon for printing unless you have a color printer. 


Use the Edit menu to cut, copy, and paste images from and to the icon. 
When you select a portion of the icon and paste an image, LabVIEW 
resizes the image to fit into the selection area. You also can drag a graphic 
from anywhere in your file system and drop it in the upper right corner of 
the front panel or block diagram. LabVIEW converts the graphic to a 

32 X 32 pixel icon. 


Use the Copy from option on the right side of the Icon Editor 
dialog box to copy from a color icon to a black-and-white icon and vice 
versa. After you selecta Copy from option, click the OK button to 
complete the change. 


Note: If you do not draw a complete border around a VI icon, the icon 
background appears transparent. When you select the icon on the block 
diagram, a selection marquee appears around each individual graphic 
element in the icon. 


Use the tools on the left side of the Icon Editor dialog box to create 
the icon design in the editing area. The normal size image of the icon 
appears in the appropriate box to the right of the editing area. The following 
tasks can be performed with these tools: 


° 
Use the Pencil tool to draw and erase pixel by pixel. 
° 


Use the Line tool to draw straight lines. To draw horizontal, vertical, 
and diagonal lines, press the <Shift> key while you use this tool to 
drag the cursor. 


: 


Use the Color Copy tool to copy the foreground color from an 
element in the icon. 


° 
Use the Fill tool to fill an outlined area with the foreground color. 
- oO 


Use the Rectangl]e tool to draw a rectangular border in the 
foreground color. Double-click this tool to frame the icon in the 
foreground color. 


Use the Filled RectangLe tool to draw a rectangle with a 
foreground color frame and filled with the background color. Double- 
click this tool to frame the icon in the foreground color and fill it with 
the background color. 


Use the Select tool to select an area of the icon to cut, copy, move, 
or make other changes. Double-click this tool and press the 
<Delete> key to delete the entire icon. 


° 


Use the Text tool to enter text into the icon. Double-click this tool to 
select a different font. (Windows) The Small Fonts option 
works well in icons. 


. mh 


Use the Foreground/Background tool to display the current 
foreground and background colors. Click each rectangle to display a 
color palette from which you can select new colors. 

e Use the options on the right side of the editing area to perform the 
following tasks: 


© Show Terminals Displays the terminal pattern of the connector 
pane. 

© OK Saves the drawing as the icon and returns to the front panel. 

o Cancel Returns to the front panel without saving any changes. 


¢ The menu bar inthe Icon Editor dialog box contains more 
editing options such as Undo, Redo, Cut, Copy, Paste , 
and Clear . 


Setting Up the Connector Pane 


To use a VI as a subVI, you need to build a connector pane, shown in 
[link]. The connector pane is a set of terminals that corresponds to the 
controls and indicators of that VI, similar to the parameter list of a function 
call in text-based programming languages. The connector pane defines the 
inputs and outputs you can wire to the VI so you can use it as a subVI. 


Define connections by assigning a front panel control or indicator to each of 
the connector pane terminals. To define a connector pane, right-click the 
icon in the upper right corner of the front panel window and select Show 
Connector from the shortcut menu. The connector pane replaces the 
icon. Each rectangle on the connector pane represents a terminal. Use the 
rectangles to assign inputs and outputs. The number of terminals LabVIEW 
displays on the connector pane depends on the number of controls and 
indicators on the front panel. The following front panel has four controls 
and one indicator, so LabVIEW displays four input terminals and one 
output terminal on the connector pane. 
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Selecting and Modifying Terminal Patterns 


Select a different terminal pattern for a VI by right-clicking the connector 
pane and selecting Patterns from the shortcut menu. Select a connector 
pane pattern with extra terminals. You can leave the extra terminals 
unconnected until you need them. This flexibility enables you to make 
changes with minimal effect on the hierarchy of the VIs. You also can have 
more front panel controls or indicators than terminals. 


A solid border highlights the pattern currently associated with the icon. The 
maximum number of terminals available for a subVI is 28. 


== 


The most commonly used pattern is shown in [link]. This pattern is used as 
a standard to assist in simplifying wiring. The top inputs and outputs are 
commonly used for passing references and the bottom inputs and outputs 
are used for error handling. Refer to the section on Clusters for more 
information about error handling. 


Note: Try not to assign more than 16 terminals to a VI. Too many terminals 
can reduce the readability and usability of the VI. 


To change the spatial arrangement of the connector pane patterns, right- 
click the connector pane and select FLip Horizontal, Flip 
Vertical, or Rotate 90 Degrees from the shortcut menu. 


Assigning Terminals to Controls and Indicators 


After you select a pattern to use for the connector pane, you must define 
connections by assigning a front panel control or indicator to each of the 
connector pane terminals. When you link controls and indicators to the 
connector pane, place inputs on the left and outputs on the right to prevent 
complicated, unclear wiring patterns in your VIs. 


To assign a terminal to a front panel control or indicator, click a terminal of 
the connector pane, then click the front panel control or indicator you want 
to assign to that terminal. Click an open space on the front panel. The 
terminal changes to the data type color of the control to indicate that you 
connected the terminal. 


You also can select the control or indicator first and then select the terminal. 


Note:Although you use the 
Wiring 


tool to assign terminals on the connector pane to front panel controls and 
indicators, no wires are drawn between the connector pane and these 
controls and indicators. 


Convert C to F VI 
Exercise: 


Problem: 


Complete the following steps to create a VI that takes a number 
representing degrees Celsius and converts it to a number representing 
degrees Fahrenheit. 


Front Panel 


1. Open a blank VI and begin building the following front panel. 


2. (Optional) Select Window>>Tile Left and Right to 
display the front panel and block diagram side by side or 
Window>>Tile Up and Down to display the front panel 
and block diagram stacked. 

3. Create a numeric control. You will use this control to enter the 
value for degrees Celsius. 


1. Select Controls>>Numeric Controls to display the 
Numeric Controls palette. Ifthe Controls palette 
is not visible, right-click an open space on the front panel 
workspace to display it. 


2 


Select the Numeric Control. Move the control to the 
front panel and click to place the control. 


3. |W 


Type deg C in the label of the control and press the 
<Enter> key or click the Enter button, shown in [link], 


on the toolbar. If you do not type the name immediately, 
LabVIEW uses a default label. 


Note: You can edit a label at any time by double-clicking the 
label, using the Labeling tool, or right-clicking and selecting 
Properties from the shortcut menu to display the property 
dialog box. 


4. Create a numeric indicator. You will use this indicator to display 
the value for degrees Fahrenheit. 


1. | ia) 


Select the Numeric Indicator located on the 
Controls>>Numeric Indicators palette. 

2. Move the indicator to the front panel and click to place the 
indicator. 

3. Type deg F inthe label and press the <Enter> key or 
click the Enter button. 


Block Diagram 


1. Display the block diagram by clicking it or by selecting 
Window>> Show Block Diagram. LabVIEW creates 
corresponding control and indicator terminal icons on the block 
diagram when you place controls and indicators on the front 
panel. The terminals represent the data type of the control or 
indicator. You should see two double-precision, floating-point 
terminals on the block diagram, one indicator, and one control. 


Note: Control terminals have a thicker border than indicator 
terminals. 


2. [=> 


Place the Multiply function, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, on the block diagram to the right of the deg C 
indicator. If the Functions palette is not visible, right-click an 
open space on the block diagram workspace to display it. 


3, [> 


Place the Add function, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, on the block diagram to the right of the 
Multiply function. 


4 123 


PlaceaNumeric Constant, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, to the lower left of the Multiply function. 
Type 1.80 in the constant. When you first place a numeric 
constant, it is highlighted so you can type a value. If the constant 
is no longer highlighted, double-click the constant to activate the 
Labeling tool. 


5 123 


Place aNumeric Constant, located on the 
Functions>>Arithmetic & Comparison>>Express 
Numeric palette, to the left of the Add function. Type 32.0 in 
the constant. 


6. [>| 


Use the Wiring tool, shown in [link], to wire the icons as shown 
in [link]. 


deg C Multiply Add 


o To wire from one terminal to another, use the Wiring tool 
to click the first terminal, move the tool to the second 
terminal, and click the second terminal. You can start wiring 
at either terminal. 

© You can bend a wire by clicking to tack down the wire and 
moving the cursor in a perpendicular direction. Press the 
spacebar to toggle the wire direction. 

© To identify terminals on the nodes, right-click the 
Multiply and Add functions and select Visible 
Items>>Terminals from the shortcut menu to display 
the connector pane on the block diagram. Return to the icons 
after wiring by right-clicking the functions and selecting 
Visible Items>>Terminals from the shortcut menu 
to remove the checkmark. 

o When you move the Wiring tool over a terminal, the 
terminal area blinks, indicating that clicking will connect the 
wire to that terminal and a tip strip appears, displaying the 
name of the terminal. If the Context Help window is 
open, the terminal area also blinks in the Context Help 
window. 

© To cancel a wire you started, press the <ESC> key, right- 
click, or click the terminal where you started the wire. 


7. Display the front panel by clicking it or by selecting 
Window>>Show Front Panel. 

8. Save the Vlas Convert C to F.vi inthe 
C:\Exercises\LabVIEW Basics I directory. 


Run the VI 


iF 


Enter a number in the numeric control and run the VI. 


1. [ey] 


Use the Operating tool, shown in [link], or the 
Labeling tool to double-click the numeric control and 
type a new number. 


2. BI 


Click the Run button, shown at left, to run the VI. 
3. Try several different numbers and run the VI again. 


Icon and Connector Pane 


iF 


Right-click the icon in the upper right corner of the front panel 
window and select Edit Icon from the shortcut menu. The 
Icon Editor dialog box appears. 


Double-click the Select tool, shown in [link], on the left side of 
the Icon Editor dialog box to select the default icon. 


. Press the <De Lete> key to remove the default icon. 


.O 


Double-click the Rectangle tool, shown in [link], to redraw 
the border. 


. Create the icon in [link]. 
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1. [A] 


Double-click the Text tool, shown in [link], and change the 
fonttoSmall Fonts . 

2. Use the Text tool to click the editing area where you will 
begin typing. 

3. Type C and F. While the text is active, you can move the text 
by pressing the arrow keys. 


4. F] 


Use the Pencil tool, shown in [link], to create the arrow. 


Note: To draw horizontal or vertical straight lines, press the 
<Shif t> key while you use the Pencil tool to drag the 
cursor. 


5. Use the Se Lect tool and the arrow keys to move the text 


and arrow you created. 
6. Select the B & W icon and click the 256 Colors button 
in the Copy from section to create a black and white icon, 


ie 


which LabVIEW uses for printing unless you have a color 


printer. 
Select the 16 Colors icon and click the 256 Colors 


button inthe Copy from section. 


8. When you complete the icon, click the OK button to close 


6. | | 


the Icon Editor dialog box. The icon appears in the 
upper right corner of the front panel and block diagram. 


Right-click the icon on the front panel and select Show 
Connector from the shortcut menu to define the connector 
pane terminal pattern. LabVIEW selects a default connector pane 
pattern based on the number of controls and indicators on the 
front panel. For example, this front panel has two terminals, deg 
C anddeg F ,so LabVIEW selects a connector pane pattern 
with two terminals, shown in [link]. 

7. Assign the terminals to the numeric control and numeric 
indicator. 


1. 


Select Help>>Show Context Help to display the 
Context Help window. 


. Click the left terminal in the connector pane. The tool 


automatically changes to the Wiring tool, and the terminal 
turns black. 


. Click the deg C control. A marquee highlights the control 


on the front panel. 


. Click an open space on the front panel. The marquee 


disappears, and the terminal changes to the data type color of 
the control to indicate that you connected the terminal. 


. Click the right terminal in the connector pane, and click the 


deg F indicator. 


. Click an open space on the front panel. Both terminals of the 


connector pane are orange. 


. Move the cursor over the connector pane. The Context 


Help window shows that both terminals are connected to 


double-precision, floating-point values. 


8. Save and close the VI. You will use this VI later in the course. 


Using SubVIs 


After you build a VI and create its icon and connector pane, you can use the 
VI as asubVI. To place a subVI on the block diagram, select 
Functions>>All Functions>>Select a VI . Navigate to the 
VI you want to use as a subVI and and double-click to place it on the block 
diagram. 


You also can place an open VI on the block diagram of another open VI. 
Use the Positioning tool to click the icon in the upper right corner of 
the front panel or block diagram of the VI you want to use as a subVI and 
drag the icon to the block diagram of the other VI. 


Opening and Editing SubVIs 


To display the front panel of a subVI from the calling VI, use the 
Operating or Positioning tool to double-click the subVI on the 
block diagram. You also can select Browse>>This VI's SubVIs. To 
display the block diagram of a subVI from the calling VI, press the 
<Ctrl> key and use the Operating or Positioning tool to double- 
click the subVI on the block diagram. 


Any changes you make to a subV]I affect only the current instance of the 
subVI until you save the subVI. When you save the subVI, the changes 
affect all calls to the subVI, not just the current instance. 


Setting Required, Recommended, and Optional Inputs and 
Outputs 


In the Context Help window, which you can access by selecting 
Help>>Show Context Help required terminals appear bold, 
recommended terminals appear as plain text, and optional terminals appear 
dimmed. The labels of optional terminals do not appear if you click the 
Hide Optional Terminals and Full Path button in the 
Context Help window. 


You can designate which inputs and outputs are required, recommended, 
and optional to prevent users from forgetting to wire subVI terminals. 


Right-click a terminal in the connector pane and select This 
Connection Is from the shortcut menu. A checkmark indicates the 
terminal setting. Select Required, Recommended, or Optional . 


For terminal inputs, required means that the block diagram on which you 
placed the subVI will be broken if you do not wire the required inputs. 
Required is not available for terminal outputs. For terminal inputs and 
outputs, recommended or optional means that the block diagram on which 
you placed the subVI can execute if you do not wire the recommended or 
optional terminals. If you do not wire the terminals, the VI does not 
generate any warnings. 


LabVIEW sets inputs and outputs of VIs you create to Recommended by 
default. Set a terminal setting to required only if the VI must have the input 
or output to run properly. Refer to the Read File function located on the 
Functions>>All Functions>>File I/O palette for examples of 
required, recommended, and optional inputs and outputs. 


Thermometer VI 
Exercise: 


Problem: 


Complete the following steps to create a VI that reads a measurement 
from the temperature sensor on the DAQ Signal Accessory and 
displays the temperature in Celsius or Fahrenheit. 


The sensor returns a voltage proportional to temperature. For example, 
if the temperature is 23°, the sensor output voltage is 0.23 V. The 
sensor is connected to Channel 0 of Device 1. Device 1 is the DAQ 
device. On some systems, the DAQ device may have another device 
number. 


Front Panel 


1. In the LabVIEW dialog box, click the arrow on the New button 
and select Blank VI from the shortcut menu or press the 
<Ctr1-N> keys to open a blank VI. 

2. Create the following front panel. 


1. Place a thermometer, located on the 
Controls>>Numeric Indicators palette, on the 
front panel. 


2. |Mj 


Type Temperature in the label and press the <Enter> 
key or click the Enter button on the toolbar, shown at left. 


3. Right-click the thermometer and select Visible 
Items>> Digital Display from the shortcut menu to 
show the digital display for the thermometer. 

4. Place a vertical toggle switch control, located on the 
Controls>>Buttons & Switches palette, on the 
front panel. 

5. Type Temp Scale in the label and press the <Enter> 
key or click the Enter button. 


6. [A] 


Use the Labeling tool, shown in [link], to place a free 
label, deg C, next to the True position of the switch. If 
you are using automatic tool selection, double-click the 
blank area of the front panel to begin typing a free label. 

7. Place a free label, deg F , next tothe False position of 
the switch. 


User Documentation 


1. Document the VI so a description appears in the Context 
Help window when you move the cursor over the VI icon. 


1. Select File>>VI Properties to display the VI 
Properties dialog box. 

2. Select Documentation from the Category pull-down 
menu. 

3. Type the following description for the VI in the VI 
description text box: This VI measures 
temperature using the temperature sensor 
on the DAQ Signal Accessory. 

4. Click the OK button. 


2. Document the thermometer indicator and switch control so 
descriptions appear in the Context Help window when you 
move the cursor over the objects and tip strips appear on the front 


panel or block diagram when you move the cursor over the 
objects while the VI runs. 


° 


Right-click the thermometer indicator and select 
Description and Tip from the shortcut menu. 

Type the following description for the thermometer in the 
Description text box: Displays the 
LeMperacure Measurenent. 

Type temperature in the Tip text box. 

Click the OK button. 

Right-click the switch control and select Description 
and Tip from the shortcut menu. 

Type the following description for the vertical switch control 
in the Description text box: Determines the 
scale (Fahrenheit or Celsius) to use for 
the temperature measurement. 


o Type scale - C or F inthe T1p text box. 


° 


Click the OK button. 


3. Select Help>>Show Context Help to display the 
Context Help window. 

4. Move the cursor over the front panel objects and the VI icon to 
display the descriptions in the Context Help window. 


Block Diagram 


1. Select Window>>Show Block Diagram to display the block 
diagram. 


DAQ Assistant 


» Temperature 
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2. 


Place the DAQ Assistant Express VI, located on the 
Functions>>Input palette, on the block diagram. When you 
place this Express VI on the block diagram the DAQ Assistant 
configuration dialog box appears. 


Ls 


Select Analog Input>>Voltage for the type of 
measurement to make. 


. Select Devi>>ai0 (or Dev2>>ai0) for the physical 


channel and click the Finish button. 


. You must multiply the temperature by 100 to convert it from 


voltage to Celsius. On the Settings tab, select Custom 
Scaling>>Create New. Select a Linear scale. Name 
the scale Temperature. Entera Slope scale of 100. 
Click the OK button. 


.Setmin = 0.Setmax = 100 
. Select the Acquire 1 Sample option on the Task 


Timing tab. Click the OK button. 


Note: If you do not have a DAQ device with a temperature 
sensor connected to your computer, use the (Demo) Read 
Voltage VI, located in the C: \Exercises LabVIEW 
Basics I directory. 


3, Ep 


Place the Convert from Dynamic Data Express VI, 
located on the Functions>>Signal Manipulation 
palette, on the block diagram. This VI converts the dynamic data 
type. In the configuration dialog box, select Single scalar in 
the Resulting data type listbox. 


4. \coF 


Place the Convert C to F VI onthe block diagram. Select 
Functions>>All Functions>>Select a VI, navigate 
to 2 NExercises\ LabVIEW Basics E\Convert.C £0 
F.Vvi. This VI converts the Celsius readings to Fahrenheit. 


5. D> 


Place the Select function, located on the 
Functions>>Arithmetic & Comparison>>Express 
Comparison palette, on the block diagram. This function 
returns either the Fahrenheit (False) or Celsius (True) 
temperature value, depending on the value of Temp Scale. Use 
the Positioning tool to place the icons as shown in the block 
diagram and use the Wiring tool to wire them together. 


Note: To display terminals for a node, right-click the icon and 
select Visible Items>>Terminals from the shortcut 
menu. 


Front Panel 


1. Display the front panel by clicking it or by selecting 
Window>>Show Front Panel . 


2. SI 


Click the Run Continuously button, shown at left, to run 
the VI continuously. 

3. Put your finger on the temperature sensor and notice the 
temperature increase. 

4. Click the Run Continuously button again to stop the VI. 
This allows the VI to finish the current run of the VI. 


Icon and Connector Pane 


1. Create an icon so you can use the Thermometer VI as asubVI. 
The following icon is an example. If necessary, create a simpler 
icon to save time. 
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1. Right-click the icon in the upper right corner of the front 
panel and select Edit Icon from the shortcut menu. The 
Icon Editor dialog box appears. 


2.63 


Double-click the Select tool, shown at left, on the left side 
of the Icon Editor dialog box to select the default icon. 
3. Press the <DelLete> key to remove the default icon. 


4. 


Double-click the Rectang le tool, shown at [link], to 
redraw the border. 


5. [F] 


Use the Pencil tool, shown in [link], to draw an icon that 
represents the thermometer. 

6. Use the Foreground and Fill tools to color the 
thermometer red. 


Note:To draw horizontal or vertical straight lines, press the 
<Shif t> key while you use the Pencil tool to drag the 
cursor. 


7. |Al 


Double-click the Text tool, shown in [link], and change the 
font to Small Fonts. 

8. Type Temp. Reposition the text if necessary. 

9. Select the B & W icon and select 256 Colors inthe 
Copy from section to create a black and white icon, 
which LabVIEW uses for printing unless you have a color 
printer. 

10. When the icon is complete, click the OK button. The icon 
appears in the upper right corner of the front panel. 


2. Right-click the icon and select Show Connector from the 
shortcut menu and assign terminals to the switch and the 
thermometer. 


1. Click the left terminal in the connector pane. 


2. Click the Temp Scale control. The left terminal turns 
green. 

3. Click the right terminal in the connector pane. 

4. Click the Temperature indicator. The right terminal turns 
orange. 

5. Click an open space on the front panel. 


3. Save the VI as Thermometer .vi in the C: \Exercises\ 
LabVIEW Basics I directory. You will use this VI later in the 
course. 

4. Close the VI. 


Creating a SubVI from Sections of a VI 


You can simplify the block diagram of a VI by converting sections of the 
block diagram into subVIs. Convert a section of a VI into a subVI by using 
the PoSitioning tool to select the section of the block diagram you want 
to reuse and selecting Edit>>Create SubVI. Anicon for the new 
subVI replaces the selected section of the block diagram. LabVIEW creates 
controls and indicators for the new subVI and wires the subVI to the 
existing wires. [link] shows how to convert a selection into a subVI. 
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The new subVI uses a default pattern for the connector pane and a default 
icon. Double-click the subVI to edit the connector pane and icon, and to 
save the subVI. 


Note: Do not select more than 28 objects to create a subVI because 28 is 
the maximum number of connections on a connector pane. 


Summary, Tips, and Tricks on Modular Programming 


A VI within another VI is called a subVI. Using subVIs helps you 
manage changes and debug the block diagram quickly. 

After you build a VI front panel and block diagram, build the icon and 
the connector pane so you can use the VI as a subVI. 

The connector pane is a set of terminals that corresponds to the 
controls and indicators of that VI. Define connections by assigning a 
front panel control or indicator to each of the connector pane 
terminals. 

Create custom icons to replace the default icon by double-clicking the 
icon in the upper right comer of the front panel to open the Icon 

Eq icon. 

In the Icon Editor dialog box, double-click the Text tool to select 
a different font. 

You can designate which inputs and outputs are required, 
recommended, and optional to prevent users from forgetting to wire 
subVI connections. Right-click a terminal in the connector pane and 
select This Connection Is from the shortcut menu. 

Document a VI by selecting File>>VI Properties and selecting 
Documentation from the Category pull-down menu. When 
you move the cursor over a VI icon, the Context Help window 
displays this description and indicates which terminals are required, 
recommended, or optional. 

Add descriptions and tip strips to controls and indicators by right- 
clicking them and selecting Description and Tip from the 
shortcut menu. When you move the cursor over controls and 
indicators, the Context Help window displays this description. 
Convert a section of a VI into a subVI by using the Positioning 
tool to select the section of the block diagram you want to reuse and 
selecting Edit>>Create SubVfI. 


While Loops 


AWhile Loop executes a subdiagram until a condition is met. The 
While Loop is similar toaDO Loop oraRepeat-Until Loop in 
text-based programming. [link] shows awhile Loop in LabVIEW, a 
flow chart equivalent of the While Loop functionality, and a pseudo code 
example of the functionality of the While Loop. 


7 
Condition 
met? 
Yes 


® ® 


The While Loop is located on the Functions>>Execution 
Control palette. Select the While Loop from the palette then use the 
cursor to drag a selection rectangle around the section of the block diagram 
you want to repeat. When you release the mouse button, awhile Loop 
boundary encloses the section you selected. 


No Repeat (code); 
Until Condition met; 


End; 


Condition met? 
iia laaieaees 


Add block diagram objects to the While Loop by dragging and dropping 
them inside the While Loop. 


Note: The While Loop always executes at least once. 


The While Loop executes the subdiagram until the conditional terminal, 
an input terminal, receives a specific Boolean value. The default behavior 
and appearance of the conditional terminal is Stop If True, shown in 
[link]. When a conditional terminal is Stop If True, theWhile Loop 


executes its subdiagram until the conditional terminal receives a True 
value. 


a) 


The 1teration terminal, an output terminal, shown in [link], contains the 
number of completed iterations. The iteration count always starts at zero. 
During the first iteration, the iteration terminal returns 0. 


In the block diagram in [link], the While Loop executes until the subVI 
output is greater than or equal to 10.00 and the Enable control is True. 
The And function returns True only if both inputs are True. Otherwise, it 
returns False. 


In the previous example, there is an increased probability of an infinite 
loop. Generally, the desired behavior is to have one condition met to stop 
the loop, rather than requiring both conditions to be met. 


te) 


You can change the behavior and appearance of the conditional terminal by 
right-clicking the terminal or the border of the While Loop and selecting 
Continue if True, shown at left. You also can use the ODerating 
tool to click the conditional terminal to change the condition. When a 
conditional terminal is Continue if True, the While Loop executes 
its subdiagram until the conditional terminal receives a False value, as 
shown in [link]. 


lteration Number 


Gj P21 


The While Loop executes until the subVI output is less than 10. 00 or 
the Enable control is False. 


Structure Tunnels 


Data can be passed out of or into aWhile Loop through a tunnel. 
Tunnels feed data into and out of structures. The tunnel appears as a solid 
block on the border of the While Loop. The block is the color of the data 
type wired to the tunnel. Data pass out of a loop after the loop terminates. 
When a tunnel passes data into a loop, the loop executes only after data 
arrive at the tunnel. 


In [link], the Lteration terminal is connected to a tunnel. The value in 
the tunnel does not get passed to the Iteration Number indicator until 
the While Loop has finished execution. 


Only the last value of the iteration terminal displays in the Iteration 
Number indicator. 


For Loops 


A For Loop executes a subdiagram a set number of times. [link] shows a 
For Loop in LabVIEW, a flow chart equivalent of the For Loop 
functionality, and a pseudo code example of the functionality of the For 
Loop. 


as N=100; 


= me 


Repeat (code; i=i+1); 


End; 


Cénd ) 
@® ® 


The For Loop is located on the Functions>>A11 
Functions>>Structures palette. You also can place aWhile 

Loop on the block diagram, right-click the border of the While Loop, 
and select Replace with For Loop from the shortcut menu to 
change awhile LooptoaFor Loop. The value in the count terminal 
(an input terminal), shown in [link], indicates how many times to repeat the 
subdiagram. 


a) 


The 1teration terminal (an output terminal), shown in [link], contains 
the number of completed iterations. The iteration count always starts at 
zero. During the first iteration, the iteration terminal returns 0. 


The For Loop differs from the While Loop in that the For Loop 
executes a set number of times. AWhile Loop stops executing the 
subdiagram only if the value at the conditional terminal exists. 


The For Loop in [link] generates a random number every second for 100 
seconds and displays the random numbers in a numeric indicator. 


Random Number (0-1) 


Fai Random Number 
Indicator 


> 
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Wait Functions 


‘a 
The Wait Until Next ms Multiple function, shown in [link], 
monitors a millisecond counter and waits until the millisecond counter 
reaches a multiple of the amount you specify. Use this function to 
synchronize activities. Place this function within a loop to control the loop 
execution rate. 


The Wait (ms) function, shown in [link], adds the wait time to the code 
execution time. This can cause a problem if code execution time is variable. 


Note: The Time Delay Express VI, located on the 
Functions>>Execution Control palette, behaves similar to the 
Wait (ms) function with the addition of built-in error clusters. Refer to 
Clusters for more information about error clusters. 


Wait Functions 


LabVIEW can represent numeric data types as signed or unsigned integers 
(8-bit, 16-bit, or 32-bit), floating-point numeric values (single-, double-, or 
extended-precision), or complex numeric values (single-, double-, or 
extended-precision). When you wire two or more numeric inputs of 
different representations to a function, the function usually returns output in 
the larger or wider format. The functions coerce the smaller representations 
to the widest representation before execution, and LabVIEW places a 
coercion dot on the terminal where the conversion takes place. 


For example, the For Loop count terminal is a 32-bit signed integer. If 
you wire a double-precision, floating-point numeric to the count terminal, 
LabVIEW converts the numeric to a 32-bit signed integer. A coercion dot 
appears on the count terminal of the first For Loop, as shown in [link]. 


double-precision, floating- _ 
point numeric value 32-bit signed integer 


Coercion Dot 


If you wire two different numeric data types to a numeric function that 
expects the inputs to be the same data type, LabVIEW converts one of the 
terminals to the same representation as the other terminal. LabVIEW 
chooses the representation that uses more bits. If the number of bits is the 
same, LabVIEW chooses unsigned over signed. 


In the example in [link], a 32-bit signed integer (132) and a double- 
precision, floating-point numeric value (DBL) are wired to the Divide 
function. The 32-bit signed integer is coerced since it uses fewer bits than 
the double-precision, floating-point numeric value. 


Output 
a > 


To change the representation of a numeric object, right-click the object and 
select Representation from the shortcut menu. Select the data type 
that best represents the data. ut data types. 


When LabVIEW converts double-precision, floating-point numeric values 
to integers, it rounds to the nearest integer. LabVIEW rounds X . 5 to the 
nearest even integer. For example, LabVIEW rounds 2.5 to 2 and 3.5 to 4. 


Refer to the Data Types section of Introduction to LabVIEW, of this manual 
or to the LabVIEW Help for more information about data types. 


Timed Temperature VI 
Exercise: 


Problem: 


Complete the following steps to build a VI that uses the Thermometer 
VI to read a temperature once every second for a duration of one 
minute. 


Front Panel 


1. Open a blank VI and build the front panel shown in [link]. 


1. Place a thermometer, located on the 
Controls>>Numeric Indicators palette, on the 
front panel. This provides a visual indication of the 
temperature reading. 

2.Placeanumeric indicator, located on the 
Controls>>Numeric Indicators palette, on the 
front panel. Label this indicator Seconds Elapsed. 
Right-click the indicator and select 
Representation>>132 from the shortcut menu. 


Block Diagram 


1. Build the block diagram shown in [link]. 


Wait Until Next ms Multiple 


Seconds Elapsed 


am 


Place aFor Loop, located on the Functions>>A11 
Functions>>Structures palette, on the block 
diagram. Right-click the Loop Count terminal in the 
upper left corner of the For Loop and select Create 
Constant from the shortcut menu. Type 60 in the constant 
to set the For LOop to repeat 60 times. 


[e) rene 


Place the Thermometer VI on the block diagram. Select 
Functions>>All Functions>>Select a VI and 
navigate to C: \Exercises\LabVIEW Basics 
I\Thermometer . vito place the VI. This VI reads the 
temperature from the DAQ device. Right-click the Temp 
Scale input and select Create>>Constant from the 
shortcut menu. Use a False constant for Fahrenheit or a 
True constant for Celsius. 


Note: If you do not have a DAQ device with a temperature 
sensor on Channel 0, use the (Demo) Thermometer VI 
instead. 


°E 
Place the Wait Until Next ms Multiple function, 
located on the Functions>>All Functions>>Time 
& Dialog palette, on the block diagram. Right-click the 
input and select Create>>Constant from the shortcut 
menu. Enter a value of 1000 to set the wait to every second. 


° > 


Place the Increment function, located on the 
Functions>>Arithmetic & 
Comparison>>Express Numeric palette, on the 
block diagram. This function adds one to the iteration 
terminal output. 


2. Save this Vlas Timed Temperature. vi in the 
C:\Exercises\LabVIEW Basics I directory. 

3. Run the VI. The first reading might take longer than one second 
to retrieve if the computer needs to configure the DAQ device. 

4. If time permits, complete the following optional and challenge 
steps, otherwise close the VI. 


Optional 


1. Build a VI that generates random numbers inaWhile Loop 
and stops when you click a stop button on the front panel. 

2. Save the Vilas General While Loop.vi inthe 
C:\Exercises\LabVIEW Basics I directory. 


Challenge 


1. Modify the General While Loop VI to stop when the stop 
button is clicked or when the While Loop reaches a number of 
iterations specified by a front panel control. 


2. Select File>>Save As to save the VI as Combo While- 
For Loop.viintheC:\Exercises\LabVIEW Basics 
I directory. 


Summary, Tips, and Tricks on Repetition and Loops 


Use structures on the block diagram to repeat blocks of code and to 
execute code conditionally or in a specific order. 

The While Loop executes the subdiagram until the conditional 
terminal receives a specific Boolean value. By default, the While 
Loop executes its subdiagram until the conditional terminal receives a 
True value. 

The For Loop executes a subdiagram a set number of times. 

You create loops by using the cursor to drag a selection rectangle 
around the section of the block diagram you want to repeat or by 
dragging and dropping block diagram objects inside the loop. 

The Wait Until Next ms Multiple function makes sure that 
each iteration occurs at certain intervals. Use this function to add 
timing to loops. 

TheWait (ms) function waits a set amount of time. 

Coercion dots appear where LabVIEW coerces a numeric 
representation of one terminal to match the numeric representation of 
another terminal. 

Use shift registers onFor Loops andWhile Loops to 
transfer values from one loop iteration to the next. 

Createa Shift register by right-clicking the left or right border 
of a loop and selecting Add Shift Register from the shortcut 
menu. 

To configure a Shift register to carry over values to the next 
iteration, right-click the left terminal and select Add Element from 
the shortcut menu. 

The Feedback Node stores data when the loop completes an 
iteration, sends that value to the next iteration of the loop, and transfers 
any data type. 

Use the Feedback Node to avoid unnecessarily long wires. 


Configuring the Appearance of Front Panels 


After you build a VI, you can configure the appearance of the front panel so 
users can more easily operate the VI. For example, you can hide the menu 
bar and scrollbars to create VIs that look and behave like standard dialog 
boxes for each platform. 


Select File>>VI Properties to configure the appearance and 
behavior of a VI. You also can right-click the VI icon on the front panel or 
block diagram and select VI Properties from the shortcut menu. You 
cannot access the VI Properties dialog box while a VI is running. 
Refer to the LabVIEW Basics II: Development Course Manual for more 
information about configuring the behavior of VIs. 


Use the Category pull-down menu at the top of the VI Properties 
dialog box to select from several different option categories, including the 
following: 


General Displays the current path where a VI is saved, its revision 
number, revision history, and any changes made since the VI was last 
saved. You also can use this page to edit the icon or the size of the 
alignment grid for the VI. 

Documentation Use this page to add a description of the VI and link 
to a help file topic. Refer to the original Thermometer VI for more 
information about documenting VIs. 

Security Use this page to lock or password-protect a VI. 

Window Appearance Use this page to configure various window 
settings. 

Window Size Use this page to set the size of the window. 

Execution Use this page to configure how a VI runs. For example, you 
can configure a VI to run immediately when it opens or to pause when 
called as a subVI. 

Editor Options Use this page to set the size of the alignment grid for 
the current VI and to change the style of control or indicator LabVIEW 
creates when you right-click a terminal and select 
Create>>Control or Create>>Indicator from the shortcut 
menu. 


Window Appearance 


In the VI Properties dialog box, select Window Appearance from 
the Category pull-down menu to customize the window appearance for 
Vis. 


These options apply to the VI when it is running. Use these options to 
change how the user interacts with the application by restricting access to 
LabVIEW features and by changing the way the window looks and 
behaves. You can make the VI look and act like a dialog box so the user 
cannot interact with other windows while the VI window is open. You also 
can remove the scrollbars and toolbar, and you can set a window to be 
centered or automatically sized to fit the screen. 


By default, the VI window title is the same as the VI name. You can 
customize the VI window title to make it more descriptive than the VI 
filename. This is useful for localized VIs so the VI window title can be 
translated to the local language. Remove the checkmark from the Same as 
VI Name checkbox to editWindow title. 


To configure the window appearance, select one of the following window 
styles. A graphical representation of each style displays on the right when 
you select the style. 


¢ Top-level Application Window Shows the title bar and menu bar, 
hides the scrollbars and toolbar, allows the user to close the window, 
allows run-time shortcut menus, does not allow resizing, and shows 
the front panel when called. 

¢ Dialog The VI functions as a dialog box in the operating system, so 
the user cannot interact with other LabVIEW windows while this VI 
window is open. This option does not prevent you from bringing 
windows of other applications to the front. (UNIX) You cannot make a 
window stay in front of all other windows. Dialog style windows stay 
on top, have no menu bar, scrollbars, or toolbar, allow the user to close 
the window but not resize it, allow run-time shortcut menus, and show 
the front panel when called. Also, if a Boolean parameter on the front 


panel is associated with the <Enter> or <Return> key, LabVIEW 
highlights the parameter with a dark border. 

¢ Default Same window style used in the LabVIEW development 
environment. 

¢ Custom Custom window style. 

¢ Customize Displays the Customize Window Appearance dialog box. 


Window Size 


In the VI Properties dialog box, select Window Size from the 
Category pull-down menu to customize the window size for VIs. This 
page includes the following components: 


e Minimum Panel Size Sets the minimum size of the front panel. If you 
allow the user to resize the window on the Window Appearance 
page, the user cannot resize the front panel smaller than the width and 
height you set on this page. 

e Size the front panel to the width and height of the entire screen 
Automatically resizes the front panel window to fit the screen when 
you run the VI. The VI does not retain a record of its original size and 
location, so it stays in the new location if you switch back to edit 
mode. 

e Maintain proportions of window for different monitor resolutions 
Resizes the VI so it takes up approximately the same amount of screen 
space when opened on a computer with a different monitor resolution. 
For example, if you develop a VI on a computer with a monitor 
resolution of , you might want to run the VI ona 
computer with a monitor resolution of . Use this control in 
conjunction with scaling one or all the objects on the front panel. 

¢ Scale all objects on front panel as the window resizes Automatically 
resizes all front panel objects with respect to and in proportion to the 
size of the front panel window. Text does not resize because the font 
sizes are fixed. Use this option when you allow the user to resize the 
front panel window. 


Opening SubVI Front Panels when a VI Runs 


A single front panel sometimes is too restrictive to present numerous 
options or displays. To solve this problem, organize VIs so the top-most VI 
presents high-level options, and subVIs present related options. 


Note: You also can use tab controls to make the front panel more usable. 


When LabVIEW calls a subVI, ordinarily the subVI runs without opening 
its front panel. If you want a single instance of the subVI to open its front 
panel when called, use the SUDVI Node Setup dialog box. If you want 
every instance of the subVI to open its front panel when called, use the VI 
Properties dialog box. 


Single Instance 


If you want a single instance of the subVI to open its front panel when 
called, right-click the subVI and select SubVI Node Setup from the 
shortcut menu to display the SUubVI Node Setup dialog box. Place 
checkmarks in the Show Front Panel when called and Close 
afterwards if originally closed checkboxes to open the 
subVI front panel when called. This dialog box also includes the following 
components: 


¢ Open Front Panel when loaded Displays the front panel when the 
subVI loads or when the VI that calls it loads. 

e Show Front Panel when called Displays the front panel when the 
subVI is called. 

e Close afterwards if originally closed If Show Front Panel 
when called also contains a checkmark and if the subVI was 
previously closed, the front panel closes after the subVI runs. 

e Suspend when called Suspends a subVI when called and waits for 
user interaction. This option is the same as selecting 


Operate>>Suspend when called. 


Every Instance 


If you want every instance of the subVI to open its front panel when called, 
open the subVI and select File>>VI Properties. Select Window 
Appearance from the Category pull-down menu, click the 
Customize button, and place checkmarks in the Show Front Panel 
When Called andClose Afterwards if Originally 
Closed checkboxes. 


Pop-up Graph VI and Use Pop-up Graph VI 
Exercise: 


Problem: 
Complete the following steps to build a VI that acquires temperature 
once every 0.5 seconds for 10 seconds, displays a subVI front panel 


that shows the acquired data in a graph, and keeps the front panel open 
until you click a button. 


Front Panel 


Open a blank VI and build the following front panel. 


Use the following guidelines to assist you in building the front panel. 


e The indicator to the right of the thermometer is a digital display 
belonging to the thermometer. Right-click the thermometer and 
select Visible Items>>Digital Display from the 
shortcut menu to display the digital value. 

e Change# of data values to signed 32-bit integer (132) 
representation. 


Block Diagram 


1. Build the following block diagram. 


# of readings 


Wed Fy | Wat Until Next 
500) LY ms Multiple 
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Place the Thermometer VI from a previous exercise on 
the block diagram. This VI acquires the current temperature 
value. 


2: hl 
Place the Wait Until Next ms Multiple function, 
located on the Functions>>All Functions>>Time 
& Dialog palette, on the block diagram. Right-click the 
input, select Create>>Constant, and type 500 in the 
constant to cause the FOr Loop to execute every 500 ms. 


3, [> 


Place the Multiply function, located on the 
Functions>>Arithmetic & 
Comparison>>Express Numeric palette, on the 
block diagram. This function multiplies each element of the 
output array by 0.50 to scale the x values to represent the 
time interval at which the VI takes the measurements. 


4. |e 


Place the Pop-up Graph VI, located in the 
C:\Exercises\LabVIEW Basics I directory, on the 
block diagram. This VI plots the temperature data on an XY 
graph. 

5. Complete the block diagram as shown in the previous figure. 


2. Save the Vias USe Pop-up Graph. vi inthe 
C:\Exercises\LabVIEW Basics I directory. 
3. Configure the subVI to display its front panel when called. 


1. Double-click the Pop-up Graph subVI to open its front 
panel. 

2. Select File>>VI Properties. 

3. Select Window Appearance from the Category pull- 
down menu. 

4. Click the Customize button. Configure the window 
appearance as shown in the dialog box. 


‘> Customize Window Appearance 


Window has title bar Window Behavior 


[_] Show menu bar 2 ae 
joating 
O Soteloeie leo ¥| Hide when LabVIEW is not active 


[_] Show toolbar when running © Modal 
Show Abort button Allow user to close window 


Show Run button [_ Allow user to resize window 


[] show Run Continuously Button [_] Allow user to minimize window 


Allow run-time shortcut menus 


Show Front panel when called 
Close afterwards if originally closed Highlight <Enter > Boolean 
[_] Show Front panel when loaded Auto-Center 


5. Click the OK button twice and save and close the subVI. If 
the front panel is not closed, it will not close after the subVI 
runs. 


4.Run the Use Pop-up Graph VI. After the VI acquires 10 
seconds of temperature data, the front panel of the Pop-up 


Graph VI displays and plots the temperature data. Click the 
DONE button to return to the calling VI. 

. Change the window appearance settings for the Pop-up Graph 
subVI to the Dialog window style. 

. Save and close the subVI. 

.Run the USe Pop-up Graph VI again. The Pop-up Graph 
subVI front panel window behaves as a dialog box. For example, 
the window stays on top of all other windows and uses the system 
colors. 

. Close all open VIs. 


Keyboard Shortcuts for Controls 


While a VI runs, you can press the <Tab> key to change the key focus 
from one control to the next. The key focus is the same as if you had 
clicked the control. While a control has the key focus, you can use the 
keyboard to enter the control value. If the control is a text or numeric 
control, LabVIEW highlights the text so you can edit it. If the control is 
Boolean, press the spacebar or the <Enter> key to change its value. 


You also can assign keyboard shortcuts to controls so users can navigate the 
front panel by pressing other keys. Right-click the control and select 
Advanced>>Key Navigation from the shortcut menu to display the 
Key Navigation dialog box. 


Note: The 
Advanced>>Key Navigation 


shortcut menu item is dimmed for indicators because you cannot enter data 
in an indicator. 


Select the shortcut key you want to assign to the control in the Key 
Assignment section. The front panel control names that appear in the 
Current Assignments listbox correspond to the owned labels of those 
controls. 


To prevent users from accessing a control by pressing the <Tab> key while 
the VI runs, place a checkmark in the Skip this control when 
tabbing checkbox. 


Temperature System VI 
Exercise: 


Problem: 


Front Panel 


e 


io 


4. 


Open the Temperature System VI located in the 
C:\Exercises\ LabVIEW Basics I directory. The 
following front panel is already built. 


The front panel contains four Boolean buttons. The mechanical 
action of the first three buttons is Latch When Pressed. 
This setting changes the control value when you click it and 
retains the new value until the VI reads it once. At this point the 
control reverts to its default value, even if you keep pressing the 
mouse button. This action is similar to a circuit breaker and is 
useful for stopping While Loops or for getting the VI to 
perform an action only once each time you set the control. The 
mechanical action of the Stop button is Latch When 
Released. This setting changes the control value only after you 
release the mouse button within the graphical boundary of the 
control. When the VI reads it once, the control reverts to the old 
value. This action guarantees at least one new value. This action 
is similar to dialog box buttons and system buttons. 


. Right-click a control and select Advanced>>Key 


Navigation from the shortcut menu to display the Key 
Navigation dialog box. 

In the Key Assignment section, assign the shortcut key 
shown in the [link]. 

Repeat [link] and [link] for each control. 


Block Diagram 


1. Examine the block diagram which is already built. 
a 


Wait Until 
Next ms 
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The Display Temp VI simulates a temperature 
measurement every 500 ms and plots it on a strip chart. 


(a 


The Display and Log Temp VI simulates a 
temperature measurement every 500 ms, plots it on a strip 
chart, and logs it to a file. 


+ 
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The Display Logged Temp VI opens a file that you 
select, reads the logged data, and displays them on a graph. 


2. Configure each subVI to display its front panel when called. 


1. Right-click the subVI and select SUbDVI Node Setup 
from the shortcut menu. 

2. Place checkmarks in the Show Front Panel when 
called andClose afterwards if originally 
closed checkboxes. 

3. Click OK to close the SUbVI Node Setup dialog box. 

4. Repeat [link] through [link] for the remaining two subVIs. 


3. Save the VI. Display the front panel and run the VI. 

4. Click each button and press the corresponding keyboard 
shortcuts. The three subVIs return to the Temperature 
System VI front panel when you press the <Enter> key. Try 
pressing the <Enter> key to do so. 

5. Stop the VI. 

6. Configure the Temperature System VI to run automatically 
when you open the VI. 


1. Select File>>VI Properties. 
2. Select Execution from the Category pull-down menu. 
3. Place a checkmark in the Run When Opened checkbox. 


7. Configure the VI so the menu bar and toolbar are not visible 
while the VI runs. 


1. Select Window Appearance from the Category pull- 
down menu. 

2. Click the Customize button. 

3. Remove the checkmarks from the Show Menu Bar and 
Show Toolbar When Running checkboxes. 

4. Click the OK button twice. 
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. Save and close all VIs. 

9. Open the Temperature System VI again. The VI runs 
automatically when you open it. Click the buttons on the front 
panel or use the keyboard shortcuts. 

10. Stop and close all VIs. 


Editing VI Properties 


Sometimes you can select VI properties that make it difficult to edit a VI. 
For example, you might select the RUN When Opened option and disable 
the menu bar and toolbar. If you set the VI to close and exit LabVIEW after 
it runs, you cannot stop the VI and edit it without it closing and exiting 
LabVIEW. This VI would be very difficult to edit. 


Note: To exit LabVIEW, you can use the Quit LabVIEW function located 
on the 


Functions>>All Functions>>Application 
Control 


palette. This function aborts all running VIs and ends the current session of 
LabVIEW. The function has one input. If it is wired, the end of the 
LabVIEW session occurs only if that input is True. If the input is not 
wired, the end of the session occurs when the node executes. 


Before you change VI properties, save a backup of the VI to a new location 
by selecting File>>Save with Options to avoid situations like the 
previous examples. 


Select the Development Distribution option to save the VI toa 
new location along with its entire hierarchy. You also can include the 
vi.1ib files in the save. After you save the backup VI, change the VI 
properties of the original VI. If you encounter a problem, you can return to 
the backup VI. 


Note: If you select the 


Remove diagrams 


option, you remove the source code of the VI. Select this option only if you 
never need to edit the VI again. Before you save a VI without the block 
diagrams, save a backup of the VI with the block diagrams. 


If you already saved a development VI with properties that make the VI 
difficult to edit, refer to the Edit Me VI exercise for more information about 


editing the VI. 


Edit Me VI 
Exercise: 


Problem: 


Front Panel 


1. Close any open VIs and open the Edit Me VI, located in the 
C:\Exercises\LabVIEW Basics I directory. The 
following front panel is already built. 


> Edit Me. vi 


Can You Edit Me? 


The VI is already running when it opens. While the VI runs, you 
cannot use the menu bar, toolbar, or keyboard shortcuts to edit or 
abort the VI. 

2. Click the Start button. After 10 seconds, the VI stops running 
and quits LabVIEW. 

3. Relaunch LabVIEW and open a blank VI. 

4. If the VI you want to edit either does not have subVIs or you do 
not know what it contains, complete [link] through [link]. 
However, if the VI you want to edit has subVIs, open one of the 
subVIs and modify the block diagram to break the subVI. For 
example, place an Add function on the block diagram and do not 
wire the inputs. Open the VI you want to edit. Because its subVI 
is nonexecutable, the VI that calls it is also nonexecutable. It 
opens in edit mode and the Run button appears broken. Make 
sure to fix the subVI after you edit the calling VI. 

5. Display the block diagram of the new VI. 

6. Place the Edit Me VI, which is already built, on the block 
diagram. The front panel for the Edit Me VI displays. Although 


J 
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13. 


you can display the block diagram of the Edit Me VI, you 
cannot edit it. 


. Select Operate>>Change to Edit Mode. A dialog box 


informs you that the VI is locked. 


. Click the UnLock button. You now can edit the VI. You also can 


unlock a VI by selecting File>>VI Properties and 
selecting Security from the Category pull-down menu. 
Select and delete the QUit LabVIEW function from the block 
diagram. 

Save and close the Edit Me VI. Close the new VI and do not 
save changes. 

Open the Edit Me VI again. 

After the VI runs, try to edit it. 

Close the Edit Me VI. 


Customizing the Controls and Functions Palettes 


You can customize the Controls and Functions palettes to add VIs 
and controls to the palettes, hide VIs and functions, or rearrange the built-in 
palettes to make the VIs and functions you use frequently more accessible. 


Adding VIs and Controls to the User Library and the 
Instrument Library 


The simplest method for adding VIs and controls to the Controls and 
Functions palettes is to save them in the Labview\user. lib 
directory. When you restart LabVIEW, the Functions>>Express 
User Libraries andControls>>Express User Controls 
palettes contain subpalettes for each directory, VI library (. 116), or menu 
(.mnu) file in the Labview\user .11b directory, and icons for each file 
in the Labview\user .11ib directory. After you add files to or remove 
files from specific directories, LabVIEW automatically updates the palettes 
when you restart LabVIEW. 


The Functions>>All Functions>>Instrument I/0 palette 
corresponds to the Llabview\instr .11b directory. Save instrument 
drivers in this directory to add them to the Functions palette. 


When you add VIs or controls to the Controls and Functions palettes 
using this method, you cannot set the name of each subpalette or the exact 
location of the VIs or controls on the palettes. 


Creating and Editing Custom Palette Views 


To control the name of each subpalette and the exact location of the VIs and 
controls you add to the Controls and Functions palettes, you must 
create a custom palette view. LabVIEW includes two built-in palette views- 
-Express and Advanced. Select Tools>>Advanced>>Edit 
Palette Views to create or edit custom palette views. 


Note: You cannot edit a built-in palette view. 


Refer to the LabVIEW User Manual and the LabVIEW Help for more 
information about palette views. 


Summary, Tips, and Tricks on Customizing VIs 


Select File>>VI Properties to configure the appearance and 
behavior of a VI. You also can right-click the VI icon on the front 
panel or block diagram and select VI Properties from the 
shortcut menu. 

If you want a single instance of the subVI to open its front panel when 
called, right-click the subVI and select SUuDVI Node Setup from 
the shortcut menu. Place checkmarks in the Show Front Panel 
when called andClose afterwards if originally 
closed checkboxes. 

If you want every instance of the subVI to open its front panel when 
called, select File>>VI Properties and select Window 
Appearance from the Category pull-down menu. Click the 
Customize button and place checkmarks in the Show Front 
Panel When Called andClose Afterwards if 
Originally Closed checkboxes. 

Assign keyboard shortcuts to controls by right-clicking the control and 
selecting Advanced>>Key Navigation from the shortcut menu. 
Before you change VI properties, save a backup of the VI to a new 
location by selecting File>>Save with Options to avoid 
making the VI difficult to edit. 

To edit a VI with properties that make the VI difficult to edit: 


o Break one of its subVIs. The VI opens in edit mode because it 
cannot run with a broken subVI. 

o If the VI has no subVIs, place it on the block diagram of a new 
VI. 


The simplest method for adding VIs and controls to the Controls 
and Functions palettes is to save them in the user . 11b directory. 
To create or edit a custom palette view, select 
Tools>>Advanced>>Edit Palette Views. 

Change to an icon- or text-only palette view by selecting from the 
Format pull-down menu. 


